Search articles by links or IDs
Searches for articles based on specified links or IDs. You can filter results by date range.
Authorizations
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.
Query Parameters
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.
Example: "1234567890abcdef, abcdef1234567890"
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.
Example: "https://example.com/article1, https://example.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.
x > 1
The number of articles to return per page.
Range: 1
to 1000
.
1 < x < 1000
Response
The response model for a search request.
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.
The status of the response.
Was this page helpful?