---
title: "News article count"
method: GET
path: "/1/count"
tags: ["Count"]
---

# News article count

`GET /1/count`

Returns the number of news articles matching the filters. With `interval=all` (default) a single total is returned; with `interval=hour` or `interval=day` a count-per-hour/day breakdown is returned. `from_date` and `to_date` are required, and at least one of the following parameters as well: `q`, `qInTitle`, `qInMeta`, `country`, `category`, `language`, `domain`, `domainurl`, `prioritydomain`, `image`, `video`, `full_content`. Available on plans with count access.

Consumes **50** API credits per call.

## Query parameters

- `apikey` string
- `q` string
- `qInTitle` string
- `qInMeta` string
- `country` string[]
- `excludecountry` string[]
- `category` string[]
- `excludecategory` string[]
- `language` string[]
- `excludelanguage` string[]
- `domain` string[]
- `domainurl` string[]
- `excludedomain` string[]
- `prioritydomain` 'top' | 'medium' | 'low'
- `from_date` string, required
- `to_date` string, required
- `image` '0' | '1'
- `video` '0' | '1'
- `full_content` '0' | '1'
- `removeduplicate` '0' | '1'
- `sentiment` 'positive' | 'neutral' | 'negative'
- `sentiment_score` number
- `tag` string[]
- `region` string[]
- `organization` string[]
- `creator` string[]
- `datatype` string[]
- `interval` 'all' | 'hour' | 'day'
- `size` integer
- `page` string
- `sort` 'pubdatedesc' | 'pubdateasc'

## Response `200`

Success. The shape depends on the `interval` parameter.

- union
  - CountSummaryEnvelope — Count response when `interval=all` (default).
    - `status` 'success', required
    - `results` object, required
      - `count` integer, required — Total number of articles matching the filters.
  - CountHistogramEnvelope — Count response when `interval=hour` or `interval=day`.
    - `status` 'success', required
    - `results` object[], required
      - `dateTime` string, required — Start of the hour/day, `YYYY-MM-DD HH:MM:SS`.
      - `count` integer, required — Number of articles in that hour/day.
    - `nextPage` string, nullable — Pass this value as the `page` parameter to get the next page. `null` when there are no more results.

## Other responses

- `400` — Invalid request — e.g. a required parameter is missing or the search query is malformed.
- `401` — Missing or invalid API key, or the request is not allowed for this key.
- `403` — Your plan does not include access to this endpoint or parameter.
- `422` — A parameter value is not supported — e.g. an unknown filter value, too many values, an invalid date, or two incompatible filters used together.
- `429` — Too many requests in a short period, rate limit exceeded, or API credits exhausted.
- `500` — Unexpected server error. Please try again later.
- `503` — The endpoint is temporarily unavailable due to maintenance.

## Changes

- **2026-08-20** `ece1fd088c73` — 14 info
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `400` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `401` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `403` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `422` status
  - …10 more
- **2026-08-13** `692a9e161b3f` — 21 warning
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `400`
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `401`
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `403`
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `422`
  - …17 more

[Change history](https://skmtc.dev/newsdata/apis/newsdata-io-api/changes/1/count/get.md)

---

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