---
title: "News sources"
method: GET
path: "/1/sources"
tags: ["Sources"]
---

# News sources

`GET /1/sources`

Returns up to 100 news sources matching the filters. Use the returned `id` with the `domain` parameter on the news endpoints.

Consumes **1** API credit per call.

## Query parameters

- `apikey` string
- `country` string[]
- `category` string[]
- `language` string[]
- `domainurl` string[]
- `prioritydomain` 'top' | 'medium' | 'low'

## Response `200`

Success.

- SourceListEnvelope — Successful source list response.
  - `status` 'success', required
  - `totalResults` integer, required — Number of sources returned (maximum 100).
  - `results` Source[], required
    - `id` string, required — Source id. Use it with the `domain` parameter on the news endpoints.
    - `name` string, nullable — Source display name.
    - `url` string, uri, nullable — Source website URL.
    - `icon` string, uri, nullable — Source icon URL.
    - `priority` integer, nullable — Source ranking (lower = higher-ranked).
    - `description` string, nullable — Short description of the source.
    - `category` string[], nullable — Categories the source covers.
    - `language` string[], nullable — Languages the source publishes in.
    - `country` string[], nullable — Countries the source covers.
    - `total_article` integer, nullable — Number of articles collected from this source.
    - `last_fetch` string, nullable — When the source was last fetched, `YYYY-MM-DD HH:MM:SS`.
  - `nextPage` unknown

## Other responses

- `401` — Missing or invalid API key, or the request is not allowed for this key.
- `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` — 10 info
  - 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 `422` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `429` status
  - added the optional property `results/oneOf[#/components/schemas/InvalidFilterDetail]/recommendations` to the response with the `500` status
  - …6 more
- **2026-08-13** `692a9e161b3f` — 15 warning
  - 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 `422`
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `429`
  - added the new `Conflict` enum value to the `results/oneOf[#/components/schemas/ErrorDetail]/code` response property for the response status `500`
  - …11 more

[Change history](https://skmtc.dev/newsdata/apis/newsdata-io-api/changes/1/sources/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)