---
title: "Get the index counts underlying AskNews"
method: GET
path: "/v1/index_counts"
tags: ["news"]
---

# Get the index counts underlying AskNews

`GET /v1/index_counts`

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

## Query parameters

- `start_datetime` string, date-time, nullable — Start timestamp to filter by
- `end_datetime` string, date-time, nullable — End timestamp to filter by
- `domains` string[], 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.
- `categories` string[], 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_voice` string[], nullable — Type of reporting voice to filer by.
- `bad_domain_url` union — blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls.
  - string[]
  - string
- `page_rank` integer, nullable — maximum allowed pagerank for returned articles
- `string_guarantee` string[], 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_guarantee` string[], nullable — If defined, the search will only occur on articles that do not contain this string.
- `entity_guarantee` string[], 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.
- `languages` string[], nullable — Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'.
- `countries` string[], 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_blacklist` string[], 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'.
- `continents` string[], nullable — Continents to filter by
- `sentiment` 'negative' | 'neutral' | 'positive', nullable — Sentiment to filter news articles by.

## Response `200`

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

- IndexCountItem[]
  - `start` string, date-time, required
  - `end` string, date-time, required
  - `count` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/asknews/apis/asknews-api.md) · [All operations](https://skmtc.dev/asknews/apis/asknews-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asknews/asknews-api/revisions/dd4286769887/schema)