Newscatcher Authors API
Operations to search by author.
Newscatcher Authors API is one of 16 APIs that Newscatcher publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Authors. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 2 operations across 1 path, and defines 56 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
56 schemas
1 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Newscatcher Authors 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.
Authors 2
Operations to search by author.
GET
/api/authors
Search articles by author
POST
/api/authors
Search articles by author
Schemas 56
The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are ArticleEntity (37 properties), NlpDataEntity (17 properties), BaseSearchResponseDto (5 properties), AdditionalDomainInfoEntity (3 properties). Each schema is shown below with its type and property counts.
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.
NotAuthorName
The list of author names to exclude from your search. To exclude articles by specific authors, use a comma-separated string or an array of strings.
NamedEntityList
array
A list of named entities identified in the article.
AuthorName
string
The name of the author to search for. This parameter returns exact matches only.
ArticleEntity
object
The data model representing a single article in the search results.
37 properties
8 required
SearchResponseDto
The response model for the search requests applies to the Search, Latest Headlines, Search by link, and Authors endpoints. Response field behavior: - Required…
IptcTags
Filters articles based on International Press Telecommunications Council (IPTC) media topic tags. To specify multiple IPTC tags, use a comma-separated string o…
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…
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…
NotLang
The language(s) to exclude from the search. The accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO639-1) code. To exclude multiple…
ToRank
integer
The highest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
ArticlesDto
array
A list of articles matching the search criteria.
UserInputDto
object
The user input parameters for the request.
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…
AllLinks
The complete URL(s) mentioned in the article. For multiple URLs, use a comma-separated string or an array of strings. For more details, see [Search by URL](htt…
FromRank
integer
The lowest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
WordCountMin
integer
The minimum number of words an article must contain. To be used for avoiding articles with small content.
IsPaidContent
boolean
Filters articles by content completeness. If false, returns only articles for which full-text content is publicly available. If true, returns all indexed artic…
AllLinksText
The text content of links mentioned in the article. Searches for links where the anchor text contains the specified terms. For multiple terms, use a comma-sepa…
IabTags
Filters articles based on Interactive Advertising Bureau (IAB) content categories.These tags provide a standardized taxonomy for digital advertising content ca…
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…
BaseSearchResponseDto
object
The base response model containing common fields for search operations.
5 properties
5 required
AdditionalDomainInfoEntity
object
Additional information about the domain of the article.
3 properties
PublishedDatePrecision
string
The precision of the published date. There are three types: - full: The day and time of an article is correctly identified with the appropriate timezone. - tim…
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…
NerName
string
The name of person, organization, location, product or other named entity to search for. To specify multiple names use a comma-separated string. Example: "Tesl…
NotIabTags
Inverse of the iabtags parameter. Excludes articles based on Interactive Advertising Bureau (IAB) content categories. These tags provide a standardized taxonom…
FailedAuthorsResponseDto
The response model for a failed Authors search request.
NlpDataEntity
object
Natural Language Processing data for the article.
17 properties
RobotsCompliant
boolean
If true, returns only articles that comply with the publisher's robots.txt rules. If false, returns only articles that do not comply with robots.txt rules. If…
SentimentScores
object
Sentiment scores for the article's title and content.
2 properties
ByParseDate
boolean
If true, the from and to parameters use article parse dates instead of published dates. Additionally, the parsedate variable is added to the output for each ar…
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…
Error
object
3 properties
3 required
AllDomainLinks
The domain(s) mentioned in the article. For multiple domains, use a comma-separated string or an array of strings. For more details, see [Search by URL](https:…
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…
IncludeTranslationFields
boolean
If true, includes English translation fields in the response (titletranslateden, contenttranslateden, and NLP translation fields).
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…
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…
From
The starting point in time to search from. Accepts date-time strings in ISO 8601 format and plain text strings. The default time zone is UTC. Formats with exam…
IsOpinion
boolean
If true, returns only opinion pieces. If false, excludes opinion-based articles and returns news only.
CustomTags
Filters articles based on provided taxonomy that is tailored to your specific needs and is accessible only with your API key. To specify tags, use the followin…
NotIptcTags
Inverse of the iptctags parameter. Excludes articles based on International Press Telecommunications Council (IPTC) media topic tags. To specify multiple IPTC…
WordCountMax
integer
The maximum number of words an article can contain. To be used for avoiding articles with large content.
To
The ending point in time to search up to. Accepts date-time strings in ISO 8601 format and plain text strings. The default time zone is UTC. Formats with examp…
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…
ParentUrl
The categorical URL(s) to filter your search. To filter your search by multiple categorical URLs, use a comma-separated string or an array of strings.
IsHeadline
boolean
If true, only returns articles that were posted on the home page of a given news domain.
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…
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:…
AllLinksDataItem
object
Detailed information about a link found in an article.
3 properties
3 required
Sources
One or more news sources to narrow down the search. The format must be a domain URL. Subdomains, such as finance.yahoo.com, are also acceptable. To specify mul…
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…
NotCountries
The publisher location countries to exclude from the search. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO3166-1…
NotSources
The news sources to exclude from the search. To exclude multiple sources, use a comma-separated string or an array of strings.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Newscatcher 12
Other APIs Newscatcher publishes across the network.
Newscatcher AggregationCount 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
Newscatcher SearchByLink API
#Authors