NEnewscatcherapi
Authors

Search by author

Search for articles written by a given author, matched as a phrase against the article's author byline. Supports filtering by language, country, source, publication date, and dozens of other parameters; does not support full-text query (q) or clustering.

post/api/authors

Request

  • Base URL
    https://v3-api.newscatcherapi.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared. Required headers: x-api-token

Headers

x-api-tokenstring required

Your NewsCatcher API key, used to authenticate this request.

Request body

author_namestring required

Author name to search for. Cannot be empty.

not_author_namestring

Exclude articles written by this author name.

sourcesunknown
predefined_sourcesunknown
not_sourcesunknown
langunknown
not_langunknown
countriesunknown
not_countriesunknown
published_date_precisionstring

Filter by how precisely the published date is known: 'full' (exact date and time), 'date' (day known, time unknown), or 'timezone unknown' (date and time known, but not the timezone).

by_parse_dateboolean

When true, the date range and sorting apply to the date NewsCatcher parsed/ingested the article instead of its published date.

sort_bystring

Sort order for results: 'relevancy' (default, best text match first), 'date' (newest first), '-date' (oldest first), or 'rank' (most authoritative source first).

from_rankinteger

Minimum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

to_rankinteger

Maximum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

parent_urlunknown
all_linksunknown
all_domain_linksunknown
all_links_textunknown
word_count_mininteger

Minimum article word count. Must be non-negative, and less than word_count_max if both are set.

word_count_maxinteger

Maximum article word count. Must be non-negative, and greater than word_count_min if both are set.

pageinteger

Page number of results to return, starting at 1.

page_sizeinteger

Number of articles per page. Integer between 1 and 1000.

include_nlp_databoolean

For NLP-enabled plans, controls whether the nlp object is included in the response for each article (excluded by default). Basic plan always includes nlp.theme regardless of this setting.

has_nlpboolean

When true, only returns articles that have NLP enrichment data. Requires an NLP plan.

themestring

Filter by article theme. One of: Business, Politics, Entertainment, Sports, Finance, Crime, Tech, General, Health, Economics, Science, Automotive, Weather, Travel, Lifestyle, Financial Crime. Comma-separated values are OR'd together; values joined with ' AND ' within one comma-separated group must all match the same article (e.g. 'Tech AND Finance,Sports' matches Tech-and-Finance articles, or Sports articles).

not_themestring

Exclude articles with any of the given themes. Same allowed values as theme, but does not support ' AND ' grouping - always excludes on any match.

title_sentiment_minnumber

Minimum sentiment score for the article title, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

title_sentiment_maxnumber

Maximum sentiment score for the article title, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

content_sentiment_minnumber

Minimum sentiment score for the article content, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

content_sentiment_maxnumber

Maximum sentiment score for the article content, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

iptc_tagsunknown
not_iptc_tagsunknown
iab_tagsunknown
not_iab_tagsunknown

Response

Successful Response

OR

Changes

No recorded changes to this operation across all 1 revision of this API.