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

---

[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/e58d9cb39db7/schema)