The ID of the author in the Content Insights system. Use it to filter a result set by the particular author.


The date that should be used as a start date for retrieving the data. Ignored if date_to is missing.


The date that should be used as an end date for retrieving the data. Ignored if date_from is missing.


Dimension to retrieve - articleauthorssectiontopic or referrer.


ID of the domain in Content Insights system. Must be provided with all API calls.

Comma-separated list of IDs of the sections to be excluded from the result. This parameter applies to all dimensions.


Comma-separated list of fields to be retrieved. No space after the comma.


Desired output format, JSON or CSV (default is JSON)


Number of results to retrieve per page (default is 20).


The number of the page to be retrieved. At the end of every response, there is a direct link to another page, if available.

The predefined period where 0 is a month (previous 30 days), 1 is one week (previous 7 days) and 2 is two weeks (previous 14 days). This parameter is ignored if both date_from and date_to is provided.

Unique identifier of the article on publisher’s side, as sent through the tracking code.

Unique identifier of the article in Content Insights system. Used for retrieving information about a particular article. Use pid parameter to search for an article based on the identifier on the publisher’s side.

The ID of the author in the Content Insights system.

The ID of the author in the Content Insights system.

The field that should be used for sorting the data. Keep in mind that any field can be used for sorting, but API explorer will give you only limited options.

Articles can be marked as freepreview or paid. Use this parameter to specify filter when retrieving data.

Important notes

Word count, a part of the result set for the article, is the word count automatically calculated by our system based on the data we retrieved in the first hour of article life. This value is not updated if the article is edited later. The calculation is done automatically by counting words in the article content stripped of all markup. The accuracy of this number is heavily dependent on the precision of the maincontent parameter of the tracking code. It’s expected that the algorithm provides different results than another way of counting words (e.g. Google docs, MS Word, various CMSs etc.).

Read depth metric uses on-the-fly calculation of word count on an hourly base and it always uses the current version of the article.

► To reach the API Explorer please click HERE.

Contact Support
If you have any issues with the API, please contact us, your feedback is greatly appreciated.