Dailyhunt is offering it’s rich catalogue of content via a seamless API integration. This document describes the details on how a partner can integrate with its Content Syndication API. It will help you understand the technical details of how you can integrate with Dailyhunt’s API, expectations from you & the API protocol specification.
\n\n\n# Change log\n\n- 29-Jan-2020 : [v2.1] Updated [**Attribution**](https://api-syndication.dailyhunt.in/#attribution) section\n- 22-May-2020 : [v2.2] Included shortned shareInfo and shareUrl for each item in items API\n- 24-Aug-2021 : [v2.3] Included appDeepLinkUrl for each row of item in items API\n- 24-Aug-2021 : [v2.3] Included appDeepLinkUrl for each row of item, homeUrl and appHomeUrl channels API\n- 24-Aug-2021 : [v2.3] Added [**Search**](https://api-syndication.dailyhunt.in/#f4cabd13-e8cf-4bf8-ba37-94b9c501317c) API details under Content Fetch section.\n\n___\n\n\n# Getting Started\n\n
This section describes the technical details of how to invoke Dailyhunt’s Syndication API. It will help you understand how to use the API security, message signing & the API protocol needed for integration.
\n\n \n \n
During onboarding, Dailyhunt will provision the following items for your integration:
\n\n\n
\n
\n
Item\n
\n
Description\n
\n
\n
\n
API Key\n
\n
API access key needed for authentication of the API client\n
\n
\n
\n
Secret Key\n
\n
Needed for signing the API parameters to generate a signature for API authentication\n
\n
\n
\n
Partner Code\n
\n
Partner identification code\n
\n
\n
\n\n\n \nYou will need to include the following items in all the API calls:\n\n\n
\n
\n
Item\n
\n
Description\n
\n
\n
\n
Unique Partner user id (puid)\n
\n
Your unique user id accessing Dailyhunt API\n
\n
\n
\n
API Key\n
\n
API access key needed for authentication of the api user\n
\n
\n
\n
API Signature\n
\n
The API authentication signature generated using Secret Key\n
\n
\n
\n
Partner Code\n
\n
Partner identification code\n
\n
\n
\n
Dailyhunt Cookie (dhFeedV1)\n
\n
Dailyhunt generated cookie (as received from the very first API call) per user\n
\n
\n
\n\n\nThe following section describes in detail, the steps needed for integration, including how to generate some of the above fields & how to include them in the API calls.\n\n# Integration Checklist\n\n- Get API Keys and partner code from Dailyhunt\n- Establish Signature generation for requests and get response from APIs\n- Puid generation: Unique id for each user to be passed for each request\n- Choose channels from Applicable options below and get configured from Dailyhunt\n\t\t- News Channels\n\t\t- Video Channels\n\t\t- DailyShare Channels\n\t\t- Location Channels\n\n- Include language onboarding for user to select content language (Recommended)\n- Integrate Tracking API\n- Place attribution request along with tracking\n- Share estimated volume and rollout plan with Dailyhunt\n\n# API Security\n\nSince the APIs are protected, you will need to generate a message signature using the secret key as described below and pass it along with the API Key to all the API calls.\n\n\n## API Key & Secret Key\n\n\n\n1. Dailyhunt will share the API Key & Secret Key with you through email.\n2. You will pass the API key on every API call.\n3. You will use the Secret Key for signing API requests & generate a _Signature Base String_ that needs to be passed on every API call.\n\n\n\n## How to generate Signature Base String\n\nTo generate a _Signature Base String_, you will need to do the following steps:\n\n\n\n1. Append _ts_=__ in the url as query parameter.\n\n2. URL encode the parameter key & value pairs.\n\n3. Sort all the request query parameters lexicographically, sorted on encoded key.\n\n4. Append all the _key=value_ with “_&_” as separator if more than one _key=value_ is present.\n\n5. Uppercase the _http_ method used in the url and in that, append the string from _#4_ above. This new string (encoded sorted parameters + uppercase http method) represents the _Signature Base String._\n\n\n**__For testing out the APIs in Postman, this collection includes a Pre-request Script, which handles the generation of Signature. You can use the test environment provided with the collection__**\n\nReplace the below values by values provided by Dailyhunt to test, in the postman environment or the below sample snippets.\n\n- PARTNER_CODE\n- YOUR_API_KEY\n- YOUR_SECRET_KEY\n\nOr use one of the below sample snippets which use API Key & Secret Key to generate signature and to invoke Dailyhunt API\n\n### Javascript sample snippet\n```\n\n\n\n\n Dailyhunt Content Syndication\n \n \n \n \n \n \n \n \n \n\n\n\n
\n
\n
\n \n\n\n\n\n```\n\n\n### Java sample snippet\n\n\n```\n/*\n * Copyright (c) 2019 Dailyhunt. All rights reserved.\n */\n\nimport java.io.BufferedWriter;\nimport java.io.FileWriter;\nimport java.io.IOException;\nimport java.io.UnsupportedEncodingException;\nimport java.net.URLEncoder;\nimport java.security.InvalidKeyException;\nimport java.security.NoSuchAlgorithmException;\nimport java.security.SignatureException;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.TreeMap;\n\nimport javax.crypto.Mac;\nimport javax.crypto.spec.SecretKeySpec;\n\nimport org.apache.commons.codec.binary.Base64;\nimport org.apache.http.HttpEntity;\nimport org.apache.http.client.methods.CloseableHttpResponse;\nimport org.apache.http.client.methods.HttpGet;\nimport org.apache.http.impl.client.CloseableHttpClient;\nimport org.apache.http.impl.client.HttpClients;\nimport org.apache.http.util.EntityUtils;\nimport org.json.simple.JSONObject;\nimport org.json.simple.parser.JSONParser;\n\npublic class APIClient {\n\n private static String PARTNER_CODE = \"\";\n private static String API_KEY_VALUE = \"\";\n private static String SECRET_KEY = \"\";\n private static String HTTP_METHOD_GET = \"GET\";\n \n public static void main(String[] args) throws Exception {\n APIClient client = new APIClient();\n \n // In query parameter always add the \"ts\" query parameter\n String queryParameter = \"&langCode=en&partner=\"+PARTNER_CODE+\"&cid=1&puid=test123&ts=\" +\n System.currentTimeMillis();\n \n // Generate the signature base string\n String signatureBase = client.generateSignatureBase(HTTP_METHOD_GET, queryParameter);\n\n // Generate the signature i.e. Message Authentication Code using HMAC\n String signature = client.calculateRFC2104HMAC(signatureBase, SECRET_KEY);\n System.out.println(\"signature = \" + signature);\n \n // Form the url & pass the API_KEY and the Signature generated in the header\n String httpUrl = \"http://feed.dailyhunt.in/api/v2/syndication/items?\" + queryParameter;\n Map headers = new HashMap<>();\n headers.put(\"Authorization\", \"key=\" + API_KEY_VALUE);\n headers.put(\"Signature\", signature);\n \n // Now call the url now\n client.httpGet(httpUrl, headers,args[0]);\n }\n\n private String calculateRFC2104HMAC(String data, String key) throws SignatureException {\n String result;\n try {\n // get an hmac_sha1 key from the raw key bytes\n SecretKeySpec signingKey = new SecretKeySpec(key.getBytes(), \"HmacSHA1\");\n \n // get an hmac_sha1 Mac instance and initialize with the signing key\n Mac mac = Mac.getInstance(\"HmacSHA1\");\n mac.init(signingKey);\n \n // compute the hmac on input data bytes\n byte[] rawHmac = mac.doFinal(data.getBytes());\n \n // base64-encode the hmac\n result = Base64.encodeBase64String(rawHmac);\n } catch (InvalidKeyException e) {\n throw new SignatureException(\"Failed to generate HMAC as key is invalid\", e);\n } catch (NoSuchAlgorithmException e) {\n throw new SignatureException(\"Failed to generate HMAC as encoding algorithm does not exists\", e);\n }\n return result;\n }\n \n private String generateSignatureBase(String httpMethod, String queryString) {\n StringBuilder signatureBaseBuffer = new StringBuilder();\n \n if (!isEmpty(queryString)) {\n Map queryParams = urlRequestParamToMap(queryString);\n \n // Sort all the request query parameters lexicographically, sorted on encoded key\n Map encodedAndSortedQueryParams = new TreeMap<>();\n for (String key : queryParams.keySet()) {\n encodedAndSortedQueryParams.put(urlEncodedString(key), \n urlEncodedString(queryParams.get(key)));\n }\n \n // Append all the key=value with “&” as separator if more than one key=value is present\n signatureBaseBuffer.append(formatAsUrl(encodedAndSortedQueryParams));\n }\n // Append the UPPERCASE(http method)\n signatureBaseBuffer.append(httpMethod.toUpperCase());\n return signatureBaseBuffer.toString();\n }\n \n private boolean isEmpty(String str) {\n return null == str || (null != str && \"\".equals(str.trim()));\n }\n \n private Map urlRequestParamToMap(String url) {\n if (isEmpty(url)) {\n return new HashMap();\n }\n\n Map keyValueMapping = new HashMap<>();\n String[] params = url.split(\"&\");\n for (String param : params) {\n String[] keyValue = param.split(\"=\");\n String key = keyValue[0];\n String value = keyValue.length == 2 ? keyValue[1] : \"\";\n keyValueMapping.put(key, value);\n }\n\n return keyValueMapping;\n }\n\n private String formatAsUrl(Map pairs) {\n if (pairs == null) {\n return \"\";\n }\n\n StringBuilder urlBuilder = new StringBuilder();\n for (String key : pairs.keySet()) {\n if (urlBuilder.length() != 0) {\n urlBuilder.append(\"&\");\n }\n urlBuilder.append(key).append(\"=\").append(pairs.get(key));\n }\n\n return urlBuilder.toString();\n }\n \n private String urlEncodedString(String normalString) {\n try {\n return URLEncoder.encode(normalString, \"UTF-8\");\n } catch (UnsupportedEncodingException e) {\n return normalString;\n }\n }\n \n private void httpGet(String url, Map headers,String fileName) throws IOException {\n CloseableHttpClient httpclient = HttpClients.createDefault();\n \n HttpGet httpGet = new HttpGet(url);\n for (String key : headers.keySet()) {\n httpGet.addHeader(key, headers.get(key));\n }\n \n CloseableHttpResponse response1 = httpclient.execute(httpGet);\n try { \n try (FileWriter writer = new FileWriter(fileName);\n BufferedWriter bw = new BufferedWriter(writer)) {\n if(response1.getStatusLine().getStatusCode() == 200){\n HttpEntity entity1 = response1.getEntity(); \n String str = EntityUtils.toString(entity1, \"UTF-8\"); \n JSONParser parser = new JSONParser();\n JSONObject json = (JSONObject) parser.parse(str);\n JSONObject data = (JSONObject)json.get(\"data\");\n System.out.println(data.get(\"count\"));\n Long c = (Long)data.get(\"count\");\n bw.write(Long.toString(c));\n }else{\n bw.write(response1.getStatusLine().getStatusCode());\n }\n } catch (IOException e) {\n System.err.format(\"IOException: %s%n\", e);\n } \n }catch(Exception ex){\n System.out.println(ex);\n }finally {\n response1.close();\n }\n\n }\n}\n\n```\n\n\n\n## Passing API Key & Signature Request Headers\n\nFollowing steps need to be followed to pass the API Key & Signature headers to Dailyhunt:\n\n1. You will pass the API key in the _Authorization_ header with value as *_key=_*.\n2. You will generate a signature (Message Authentication Code - MAC) using the secure message Authentication code algorithm SHA1-HMAC as explained below:\n a. Generate a signature (S), _S = SHA1-HMAC(Secret Key, Signature Base String)_.\n b. Base64 encode the signature (S), let's call it _S64_.\n3. While calling the API, include the signature (S) in the header as *_Signature:_*\n4. If the API key & the signature are correct, Dailyhunt server will allow the API access, otherwise it will return error codes.\n\n\n### References\n\nHMAC\n[https://en.wikipedia.org/wiki/Hash-based_message_authentication_code](https://en.wikipedia.org/wiki/Hash-based_message_authentication_code) \n\nJava HMAC\n[https://commons.apache.org/proper/commons-codec/apidocs/org/apache/commons/codec/digest/HmacUtils.html](https://commons.apache.org/proper/commons-codec/apidocs/org/apache/commons/codec/digest/HmacUtils.html) \n\n[http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AuthJavaSampleHMACSignature.html](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AuthJavaSampleHMACSignature.html) \n\n## Error Codes\n\nYou will get below error codes for failures:\n\n
\n
\n
401
If invalid API key is given in the request header
\n
\n\n\n
\n
403
If invalid Signature is given in the request heade
\n
\n
\n
500
For any unexpected issues at Dailyhunt
\n
\n
\n\n \n\nExample\n\n\tcurl -H\"Authorization:key=\" -H\"Signature:\"\" \"http:///api/v2/syndication/channels?partner=xxxx&puid=&ts=\"\n\n\n## Handling CORS\n\nDailyhunt API can also be integrated directly from the browser. In order to avoid Cross-Origin issue, Dailyhunt supports Cross-Origin Resource Sharing (CORS). Dailyhunt will provide the following headers in the preflight response with OPTIONS http method.\n\n_Access-Control-Allow-Origin:_\n\n_Access-Control-Allow-Credentials: true_\n\nFor more information on CORS, you may refer [https://en.wikipedia.org/wiki/Cross-origin_resource_sharing](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) \n\n# API Integration Environments\n\nFollowing lists the integration environments available:\n\n\n
The stage integration environment for development & testing\n
\n
\n
\n
Prod\n
\n
feed.dailyhunt.in\n
\n
80\n
\n
The production environment\n
\n
\n
\n\n# Identity Management\n\nA unique user id is needed for every user accessing and consuming Dailyhunt’s content. \nDailyhunt uses the user id to understand the user’s content consumption pattern and to serve personalized content to the user.\n\n\nFollowing sections describe how you can pass a unique user id and the need for a Dailyhunt Cookie which needs to be maintained at your end.\n\n\n### Unique User ID\n\n\n\n1. You will need to provide a unique user id as query parameter in the Dailyhunt API calls. This could be any identifier such as a device identifier, if accessible and available.\n\n>Parameter Name: {{puid}}\n> \n>Example: http://host:port/{{api_url}}?puid={{Your_unique_user_id}}\n\n\n\n2. Dailyhunt will generate & maintain an internal (Dailyhunt side) user id corresponding to your unique user id.\n\n\n### Dailyhunt Cookie\n\n\n\n1. When you access Dailyhunt API with your Unique User Id (i.e. “_puid_”) in the query parameter, Dailyhunt API will provide a user specific Cookie (_dhFeedV1_) in the API response.\n\n2. You are expected to maintain the _dhFeedV1_ Cookie per user at your end and pass it back on subsequent Dailyhunt API calls. For common browser based integrations, this should happen seamlessly.\n\n3. Dailyhunt will take care of (re-)generating the _dhFeedV1_ Cookie, if found missing in the request or if the Cookie is expired. Dailyhunt will reject the request if _dhFeedV1 _Cookie is found invalid.\n\n4. Dailyhunt Cookie helps avoid repeated lookup of the Dailyhunt internal user id for a given partner user id (_puid_) in every API call.\n\n5. Dailyhunt Cookie will be having a TTL of one month initially (and this may change in future).\n\n___\n\n# Available Language Codes\n\nFollowing table lists the available language codes supported by Dailyhunt’s content feeds. \n\nNote: Some of the channels may not have content for all languages. Please therefore review the feeds for the language of choice prior to rolling out your integration for a chosen language.\n\n\n
\n
\n
Code\n
\n
Language Name\n
\n
\n
\n
en\n
\n
English\n
\n
\n
\n
hi\n
\n
Hindi\n
\n
\n
\n
mr\n
\n
Marathi\n
\n
\n
\n
gu\n
\n
Gujarati\n
\n
\n
\n
pa\n
\n
Punjabi\n
\n
\n
\n
bn\n
\n
Bangla\n
\n
\n
\n
kn\n
\n
Kannada\n
\n
\n
\n
ta\n
\n
Tamil\n
\n
\n
\n
te\n
\n
Telugu\n
\n
\n
\n
ml\n
\n
Malayalam\n
\n
\n
\n
or\n
\n
Oriya\n
\n
\n
\n
ur\n
\n
Urdu\n
\n
\n
\n
bh\n
\n
Bhojpuri\n
\n
\n
\n
ne\n
\n
Nepali\n
\n
\n
\n\n___\n\n\n# Image Resolutions\n\n## Handling Image Url for Different Resolutions/Quality\n\nThe content fetch API provides *_images_* field, having one or more image urls for the story card. The image url will have the following format:\n\n>[http://bcdn.newshunt.com/{CMD}/{W}x{H}_{Q}/(image_folder).{EXT}]\n\nWhere,\n\n* **_{CMD}_** = one of _“crop”_ or _“resize”_\n\tIf cropped, Dailyhunt will return the exact image size center cropped\n\tIf resized, Dailyhunt will return the size closest to the one specified.\n\n* **_{W}_** = Desired width of the image based on your user’s device dimension\n* **_{H}_** = Desired height of the image based on your user’s device dimension\n* **_{Q}_** = Desired image quality in percentage based on user’s network quality, highest possible value is 100 and quality value is directly proportional to the image file size\n* **_{EXT}_** = Desired image extension such as _webp_, _jpg_, etc.\n\nYou should take care of replacing the above placeholders with appropriate values matching your user’s device & network speed qualifier. \n\nDailyhunt will dynamically generate each image matching your criteria & cache on Dailyhunt’s CDN.\n\n\n# Content Types \n\nPossible values of the \"_Content Type_\" of a card are as follows:\n\n\n
\n
\n
Content Type\n
\n
Applicable Fields from (/api/v2/syndication/items)\n
\n
\n
\n
STORY\n
\n
All the fields except \"collectionItems\"\n
\n
\n
\n
VIDEO\n
\n
All the fields except \"collectionItems\"\n
\n
\n
\n
PHOTO\n
\n
All the fields except \"collectionItems\"\n
\n
\n
\n
\n ASTROLOGY (similar to STORY, belonging to ASTRO category)\n
\n
\n All the fields except \"collectionItems\"\n
\n
\n
\n
VHMEME (Dailyshare cards)\n
\n
All the fields except \"collectionItems\"\n
\n
\n
\n
BANNER\n
\n
images & deepLinkUrl\n
\n
\n
\n
QUESTION_MULTI_CHOICES\n
\n
All the fields including \"collectionItems\" \n
\n
\n
\n
HTML\n
\n
*description* & *deepLinkUrl* (description will have HTML content for dynamic content channels such as for Elections, Cricket etc)\n
\n
\n
\n\n\n\n# Feature Mask for advanced features\n\nThe __**pfm(Partner feature mask)**__ parameter in Channels and Items API controls which features are enabled for a particular partner or channel.\nIn basic integration, only news items are served under each channel.\nFor advanced cards and features like videos and DailyShare cards etc, the appropriate value of __**pfm**__ has to be set.\n\nThe value of pfm is the sum of all bit vlaues of desired features by a partner. \n\nEach feature is controlled by a specific bit defined.\n\nList of available features:\n\n\n
\n
\n
Feature\n
\n
Value\n
\n
\n
\n
LIVE_TV_CARD\n
\n
1\n
\n
\n
\n
CRICKET_CARD(Brief)\n
\n
8\n
\n
\n
\n
HERO_CARD\n
\n
16\n
\n
\n
\n
VIDEO_CHANNELS\n
\n
32\n
\n
\n
\n
VIRAL_CHANNELS\n
\n
64\n
\n
\n
\n
CRICKET_CARD(Detailed)\n
\n
128\n
\n
\n
\n\n\n*Bit 2 and 4 are reserved for some default feature.\n\nFor example:\n\nIf a partner wants to get HERO cards and Videos, the pfm value needs to be set to 16+32 = 48\n\nIdeally, the pfm should be set at the channels API level. The contenUrl of each channel in the response inherently has the desired value of *_fm_*.\n\nThe value of *_fm_* of a particular channel should only be modified in case there is specific change needed in one particular channel. \n\n\n\n# UI Type - Content Type Mapping\n\n\n
\n
\n
Content Type type\n
\n
Card Layout uiType\n
\n
Example\n
\n
\n
\n
STORY\n
\n
NORMAL \\\n(with image)\n
\n
\n\t\n\t\n\n
\n
\n
\n
STORY\n
\n
NORMAL (without image)\n
\n
\n\t\n
\n
\n
\n
STORY\n
\n
HERO\n
\n
\n \n \n
\n
\n
\n
STORY\n
\n
TILE_3\n
\n
\n\n
\n
\n
\n
PHOTO\n
\n
TILE_3\n
\n
\n\n
\n
\n
\n
PHOTO\n
\n
GRID_3\n
\n
\n\n
\n
\n
\n
PHOTO\n
\n
GRID_5\n
\n
\n\n
\n
\n
\n
VIDEO\n
\n
NORMAL\n
\n
\n\n
\n
\n
\n
VIDEO\n
\n
HERO\n
\n
\n\n
\n
\n
\n
BANNER\n
\n
NORMAL\n
\n
\n\n
\n
\n
\n
QUESTION_MULTI_CHOICES\n
\n
GRID\n
\n
\n\n
\n
\n
\n
QUESTION_MULTI_CHOICES\n
\n
TAGS\n
\n
\n\n
\n
\n
\n
QUESTION_MULTI_CHOICES\n
\n
CAROUSEL\n
\n
\n\n
\n
\n
\n\n\n\n# Managing Clickouts\n\n\n\n- When your user clicks on a story card, you will invoke the story card **deepLinkUrl** which is given in the [**syndication/items** api response](https://api-syndication.dailyhunt.in/#b35b0121-ae73-4532-8d83-8d5bd0834f0d) \n\n\tYou need to add the below to **deepLinkUrl**:\n\t* Unique **puid** \n\t* **Dailyhunt Cookie (dhFeedV1)** while calling **deepLinkUrl**\n\t\n\tFor e.g:\n\t\n\tIf the deepLinkUrl received from the items API is:\n\t\n\t> http://m.dailyhunt.in/news/india/english/ibtimes-epaper-ibtimes/just+let+the+original+be+malaika+arora+on+chaiyya+chaiyya+being+recreated-newsid-168150810?mode=pwa&s=&ss=Browser-Feed&utm_source=&utm_medium=Browser-Feed&utm_campaign=-Browser-Feed&lite=true&prevRef=1&partnerRef=%7B%22pid%22%3A%22%22%7D\n\t\n\tappend **puid**\n\t\n\t> http://m.dailyhunt.in/news/india/english/ibtimes-epaper-ibtimes/just+let+the+original+be+malaika+arora+on+chaiyya+chaiyya+being+recreated-newsid-168150810?mode=pwa&s=&ss=Browser-Feed&utm_source=&utm_medium=Browser-Feed&utm_campaign=-Browser-Feed&lite=true&prevRef=1&partnerRef=%7B%22pid%22%3A%22%22%7D**&puid={puid_value}**\n\n- Dailyhunt will include the some explicit tracking parameters in the **deepLinkUrl**. These parameters should be retained as is.\n\nFor eg: s, ss, utm_medium, partnerRef etc.\t\n\t\n\n__*These are important to ensure proper tracking and attribution.*__\n\n\nThe deep link URL will either open in the browser (if user does not have Dailyhunt app installed) or in the Dailyhunt app (if user has Dailyhunt app installed & chooses to open with Dailyhunt app)\n\n\n\n\n\n# Managing Tracking\n\nTo help measure/track the cards seen by the user, you will need to pass the tracking data for each item card seen by your user. To enable this, Dailyhunt provides the tracking data & tracking POST URLs in the Content Fetch API response.\n\nThis tracking needs to be enabled for each list view. \nA call is required to be made to dailyhunt tracking server for every list view that is invoked:\n\n * As the first page in a new channel \n * As the next page in the same channel\n * On load of the list\n \n\n### How to track the seen cards\n\n1. Dailyhunt provides **trackData** field for each card, this is mentioned in the [**Content Fetch API**](https://api-syndication.dailyhunt.in/#b35b0121-ae73-4532-8d83-8d5bd0834f0d) section,\n2. In the same response above, Dailyhunt also provides a tracking POST URL via the **trackUrl** field.\n\nYou will need to form an array of the **trackData** values and POST the same to the **trackUrl** for the cards seen by the user. \nFor e.g, if the pageSize is 10, the track request will contain 10 items in the array.\n\nYou can do this periodically or every time user sees a page worth of cards (as close to the user activity as possible). Please refer to [**Tracking API**](https://api-syndication.dailyhunt.in/#a2d23afb-1a6c-426c-85b4-7a6241bc402f) for more details.\n\n# Attribution \n\nComScore is a provider for audience measurement using Unified Digital Measurement® (UDM) methodology, which accounts for all unique site visitors from all platforms.\nIt is an industry standard traffic attribution tool that helps advertisers validate attributable traffic data to each site / app / service etc. \n\nFor each __Pageview__ that occurs on a particular URL, a single ping is sent to ComScore to count the respective pageview as valid. You can find more info here - https://www.comscore.com/About\n\n\n## Comscore ListView attribution\n\nThe requirement is that the partner places this tracking pixel on the list page so that all list pageviews that occur can be attributed as Dailyhunt content pageviews on ComScore. When each page is loaded (page 1, page 2 etc.), this ping will need to be made.\n\nA call is required to be made to comscore for every list view that is invoked:\n\n * As the first page in a new channel \n * As the next page in the same channel\n * On load of the list\n\nThis can be done alongside each tracking call for list views.\n\n### How to get the ComScore Url?\n\nThe ComscoreUrl that needs to be pinged is available as a part of [**Content Fetch API**](https://api-syndication.dailyhunt.in/#b35b0121-ae73-4532-8d83-8d5bd0834f0d) , as shown below:\n\n```\n \"track\": {\n \"comscoreUrls\": [\n \"http://b.scorecardresearch.com/p?c1=2&c2=21733245&c4=http://m.dailyhunt.in/news/&c9=m.dailyhunt.in\"\n ]\n }\n```\n\nThere are two options to do this basis the protocol used HTTP or HTTPS .\n1. Via javascript placed within the page (for browser integrations)\n2. Direct call (for native or any other non-browser integrations)\n\n### Javascript Approach\n\nInclude the below script tag for every list view:\n\n\t \n\t\n### Direct URL Approach\n\nIn this approach the client loading content page needs to fire a call to ComScore url fetched from the API.\n\nThis calls sets cookie back to client on 1st time call. Client needs to pass this cookie in all subsequent calls to ComScore. All standard libraries handles it automatically.\n\n\n\n# Collecting User Feedback On Cards\n\nFor all the cards displayed at your end, your user may want to give feedback about the cards seen. Dailyhunt provides ability to show the specific feedback options that can be displayed to your user & allow to send the signals to the Dailyhunt server. Dailyhunt will use these signals to further improve the personalized feed of your user.\nRefer : [Feedback API](https://api-syndication.dailyhunt.in/#74e3a9ab-693f-4743-83d0-366d24eea240)\n\n\n\n# Integration Points Of Contact\n\n\n
![](\"https://imgur.com/e0G5V4Z.png\" "\\"story_normal_img\\"")
\n\t![](\"https://imgur.com/YzaqU7f.png\" "\\"story_normal_img\\"")
\n\n ![](\"https://imgur.com/aoNPCiw.png\" "\\"story_normal\\"")
\n ![](\"https://imgur.com/i4Wtdco.png\" "\\"story_hero\\"")
\n ![](\"https://imgur.com/Mb5utcK.png\" "\\"story_hero\\"")
\n ![](\"https://imgur.com/lDZa2G9.png\" "\\"story_tile_3\\"")
\n ![](\"https://imgur.com/i3UKx2K.png\" "\\"photo_grid_3\\"")
\n ![](\"https://imgur.com/FZ5ohfc.png\" "\\"photo_grid_5\\"")
\n ![](\"https://imgur.com/BkeNnVH.png\" "\\"video_normal\\"")
\n ![](\"https://imgur.com/rtYL66n.png\" "\\"video_hero\\"")
\n ![](\"https://imgur.com/K76LEi2.png\" "\\"banner_normal\\"")
\n ![](\"https://imgur.com/00PZKh2.png\" "\\"q_multi_grid\\"")
\n ![](\"https://imgur.com/6jUNzFj.png\" "\\"q_multi_tags\\"")
\n ![](\"https://imgur.com/jlTMzW2.png\" "\\"q_multi_carousel\\"")
\n