How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Newscatcher Sources API

Operations to retrieve local news sources.

Newscatcher Sources API is one of 16 APIs that Newscatcher publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sources. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 1 path, and defines 21 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://local-news.newscatcherapi.com, https://v3-api.newscatcherapi.com.

2 operations 1 paths 21 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://v3-api.newscatcherapi.com/api
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Newscatcher Sources API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-token (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API Key to authenticate requests. To access the API, include your API key in the x-api-token header. To obtain your API key, complete the [form](https://www.ne…

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Sources 2

Operations to retrieve local news sources.

POST
/api/sources
Retrieve sources
Sources_post body → 200400401403408422429500
GET
/api/sources
Retrieve sources
sourcesGet 11 params → 200400401403408422429500

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are AdditionalSourceInfo (7 properties), SourceInfo (4 properties), SourcesRequestDto (3 properties), SourcesResponseDto (3 properties). Each schema is shown below with its type and property counts.

SourcesRequestDto
object
3 properties
Lang
The language(s) of the search. The only accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO639-1) code. To select multiple language…
SourcesUserInputDto
object
The user input parameters used to search local news sources.
3 properties
Countries
The countries where the news publisher is located. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO3166-1alpha-2) c…
Theme
Filters articles based on their general topic, as determined by NLP analysis. To select multiple themes, use a comma-separated string or an array of strings. T…
Error
object
3 properties 3 required
SourcesResponseDto
object
The response model for the Sources request. Response field behavior: - Required fields are guaranteed to be present and non-null. - Optional fields may be null…
3 properties 3 required
NewsType
Filters results based on the news type. Multiple types can be specified using a comma-separated string or an array of strings. For a complete list of available…
AdditionalSourceInfo
object
The data model for additional information about a news source.
7 properties
SourceName
Specifies terms to search within the source names. To specify multiple terms, use a comma-separated string or an array of strings. Note: The search does not re…
ToRank
integer
The highest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
FromRank
integer
The lowest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
Lang_2
The language(s) of the search. The only accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO639-1) code. To select multiple language…
IsNewsDomain
boolean
If true, filters results to include only news domains.
NewsDomainType
string
Filters results based on the news domain type. Possible values are: - Original Content: Sources that produce their own content. - Aggregator: Sources that coll…
SourcesResponseDto_2
object
The response model for a successful Sources request retrieving news sources matching the specified criteria. Response field behavior: - Required fields are gua…
3 properties 3 required
SourceInfo
object
The data model for information about a news source.
4 properties 1 required
Countries_2
The countries where the news publisher is located. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO3166-1alpha-2) c…
SourceUrl
The domains of the news publication to search for. To specify multiple news sources, use a comma-separated string or an array of strings. Caution: When specify…
IncludeAdditionalInfo
boolean
If true, returns the following additional datapoints about each news source: - nbarticlesfor7d: The number of articles published by the source in the last week…
PredefinedSources
Predefined top news sources per country. Format: start with the word top, followed by the number of desired sources, and then the two-letter country code [ISO…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newscatcher-sources-api-openapi.yml Raw ↑

Other APIs Newscatcher publishes across the network.

Newscatcher AggregationCount API
Newscatcher Authors API
Newscatcher BreakingNews API
Newscatcher Datasets API
Newscatcher Entities API
Newscatcher Jobs API
Newscatcher LatestHeadlines API
Newscatcher Meta API
Newscatcher Monitors API
Newscatcher Projects API
Newscatcher Search API
Newscatcher SearchBy API
Where this information came from

This is an independent, third-party profile of Newscatcher Sources API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.