Search articles by links or IDs

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 or contact us directly.

The Newscatcher article ID (corresponds to the _id field in API response) or a list of article IDs to search for. To specify multiple IDs, use a comma-separated string or an array of strings.

Examples:

• "5f8d0d55b6e45e00179c6e7e,5f8d0d55b6e45e00179c6e7f"
• ["5f8d0d55b6e45e00179c6e7e","5f8d0d55b6e45e00179c6e7f"]

Note: You can use either the links or the ids parameter, but not both at the same time.

The article link or list of article links to search for. To specify multiple links, use a comma-separated string or an array of strings.

Examples:

• "https://nytimes.com/article1, https://bbc.com/article2"
• ["https://nytimes.com/article1", "https://bbc.com/article2"]

Note: You can use either the links or the ids parameter, but not both at the same time.

The starting point in time to search from. The publication date of the article is used. The default time zone is UTC. Available formats:

• YYYY/mm/dd
• YYYY/mm/dd HH:MM:SS
• English phrases like 1 day ago.

The ending point in time to search up to. The publication date of the article is used. The default time zone is UTC. Available formats:

• YYYY/mm/dd
• YYYY/mm/dd HH:MM:SS
• English phrases like 1 day ago.

The page number to scroll through the results. This parameter is used to paginate: scroll through results because one API response cannot return more than 1000 articles.

The number of articles to return per page. Range: 1 to 1000.

The status of the response.

The total number of articles matching the search criteria.

The current page number of the results.

The total number of pages available for the given search criteria.

The number of articles per page.

A list of articles matching the search criteria.

The user input parameters for the search.