Newscatcher BreakingNews API is one of 16 APIs that Newscatcher publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include BreakingNews. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes
2 operations
across 1 path,
and defines 29 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.
The identity and technical contract details declared by the specification.
TopNArticles
integer
Controls the number of top articles to include for each breaking news event. Important limitations: - Maximum value is 100. - The product of topnarticles x pag…
RankedOnly
boolean
If true, limits the search to sources ranked in the top 1 million online websites. If false, includes unranked sources which are assigned a rank of 999999.
ToRank
integer
The highest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
UserInputDto
object
The user input parameters for the request.
LocEntityName
string
Filters articles that mention specific location names, as identified by NLP analysis. - To specify multiple locations, use AND, OR, NOT operators, and \" escap…
FromRank
integer
The lowest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
NlpDataEntity
object
Natural Language Processing data for the article.
17 properties
ContentSentimentMax
number
Filters articles based on the maximum sentiment score of their content. Range is -1.0 to 1.0, where: - Negative values indicate negative sentiment. - Positive…
Theme
string
Filters articles based on their general topic, as determined by NLP analysis. To select multiple themes, use a comma-separated string. To learn more, see [NLP…
NamedEntityList
array
A list of named entities identified in the article.
SentimentScores
object
Sentiment scores for the article's title and content.
2 properties
PageSize
integer
The number of articles to return per page.
HasNlp
boolean
If true, filters results to include only articles that have NLP data. Note: NLP data is only available for articles indexed from July 2023 onward. Applying thi…
Error
object
3 properties
3 required
IncludeNlpData
boolean
If true, includes an NLP object for each article in the response. This object provides results of NLP analysis, including article theme, summary, sentiment, ta…
BreakingNewsArticleEntity
object
The data model representing a single article in the Breaking news search results.
33 properties
8 required
OrgEntityName
string
Filters articles that mention specific organization names, as identified by NLP analysis. - To specify multiple organizations, use AND, OR, NOT operators, and…
IncludeTranslationFields
boolean
If true, includes English translation fields in the response (titletranslateden, contenttranslateden, and NLP translation fields).
PerEntityName
string
Filters articles that mention specific person names, as identified by NLP analysis. - To specify multiple names, use AND, OR, NOT operators, and \" escape lite…
SortBy
string
The sorting order of the results. Possible values are: - relevancy: The most relevant results first. - date: The most recently published results first. - rank:…
BreakingNewsEventEntity
object
The data model representing a breaking news event with its associated articles.
3 properties
3 required
MiscEntityName
string
Filters articles that mention other named entities not falling under person, organization, or location categories. Includes events, nationalities, products, wo…
ContentSentimentMin
number
Filters articles based on the minimum sentiment score of their content. Range is -1.0 to 1.0, where: - Negative values indicate negative sentiment. - Positive…
BaseSearchResponseDto
object
The base response model containing common fields for search operations.
5 properties
5 required
NotTheme
string
Inverse of the theme parameter. Excludes articles based on their general topic, as determined by NLP analysis. To exclude multiple themes, use a comma-separate…
Page
integer
The page number to scroll through the results. Use for pagination, as a single API response can return up to 1,000 articles. For details, see [Retrieve large d…
TitleSentimentMin
number
Filters articles based on the minimum sentiment score of their titles. Range is -1.0 to 1.0, where: - Negative values indicate negative sentiment. - Positive v…
BreakingNewsResponseDto
The response model for the breaking news requests. Response field behavior: - Required fields are guaranteed to be present and non-null. - Optional fields may…
TitleSentimentMax
number
Filters articles based on the maximum sentiment score of their titles. Range is -1.0 to 1.0, where: - Negative values indicate negative sentiment. - Positive v…
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Newscatcher publishes across the network.
