Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
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 15 schemas. It is described by OpenAPI 3.0.3, at version 1.2.0.

Requests are made against a single base URL, https://local-news.newscatcherapi.com.

2 operations 1 paths 15 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.2.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 15

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

ToRank
integer
The highest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
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…
FromRank
integer
The lowest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
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…
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…
Error
object
3 properties 3 required
SourcesRequestDto
object
3 properties
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
IsNewsDomain
boolean
If true, filters results to include only news domains.
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…
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…
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
AdditionalSourceInfo
object
The data model for additional information about a news source.
7 properties
SourcesUserInputDto
object
The user input parameters used to search local news sources.
3 properties

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