news

Get the index counts underlying AskNews

This endpoint is primarly used for the publisher dashboard, to show the number of articles indexed per source.

get/v1/index_counts

Query parameters

start_datetimestring date-time nullable

Start timestamp to filter by

Start timestamp to filter by

end_datetimestring date-time nullable

End timestamp to filter by

End timestamp to filter by

domainsstring[] nullable

Domain or list of domains to get indexing counts for

Domain or list of domains to get indexing counts for

sampling'5m' | '1h' | '12h' | '1d' | '1w' | '1m'

Sampling to use

Sampling to use

time_filter'crawl_date' | 'pub_date'

Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.

Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.

categoriesstring[] nullable

Categories of news to filter on

Categories of news to filter on

provocative'unknown' | 'low' | 'medium' | 'high' | 'all' nullable

Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.

Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.

reporting_voicestring[] nullable

Type of reporting voice to filer by.

Type of reporting voice to filer by.

string[]
OR
string

blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls.

page_rankinteger nullable

maximum allowed pagerank for returned articles

maximum allowed pagerank for returned articles

string_guaranteestring[] nullable

If defined, the search will only occur on articles that contain this string.

If defined, the search will only occur on articles that contain this string.

string_guarantee_op'AND' | 'OR'

Operator to use for string guarantee.

Operator to use for string guarantee.

reverse_string_guaranteestring[] nullable

If defined, the search will only occur on articles that do not contain this string.

If defined, the search will only occur on articles that do not contain this string.

entity_guaranteestring[] nullable

Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']

Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']

entity_guarantee_op'AND' | 'OR'

Operator to use for entity guarantee.

Operator to use for entity guarantee.

languagesstring[] nullable

Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'.

Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'.

countriesstring[] nullable

Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.

Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.

countries_blackliststring[] nullable

Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.

Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.

continentsstring[] nullable

Continents to filter by

Continents to filter by

sentiment'negative' | 'neutral' | 'positive' nullable

Sentiment to filter news articles by.

Sentiment to filter news articles by.

Response

A time-series for distribution of index counts for domains.

startstring date-time required
endstring date-time required
countinteger required

Changes

No recorded changes to this endpoint across all 1 revision of this API.