ASasknews
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

Request

Query parameters

start_datetimestring date-time nullable

Start timestamp to filter by

end_datetimestring date-time nullable

End timestamp to filter by

domainsstring[] nullable

Domain or list of domains to get indexing counts for

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

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.

categoriesstring[] nullable

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.

reporting_voicestring[] nullable

Type of reporting voice to filer by.

string[]
OR
string
page_rankinteger nullable

maximum allowed pagerank for returned articles

string_guaranteestring[] nullable

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

string_guarantee_op'AND' | 'OR'

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.

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_op'AND' | 'OR'

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'.

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'.

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'.

continentsstring[] nullable

Continents to filter by

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

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 operation across all 11 revisions of this API.