The news archive endpoint provides access to the old news data for a topic, event, country, for a specific category in a country, or for a single or multiple domainurl.
Retrieving a piece of old news allows you to get the past news data for research and analysis purposes.
The News Archive endpoint is available only in paid plans.You can access news data for up to 10 years using the Archive endpoint, depending on your subscription.
For every API request made to the Archive endpoint, 5 API credits will be consumed.
Resource URL
https://newsdata.io/api/1/archive?apikey=YOUR_API_KEY&from_date=2025-03-13&to_date=2025-03-26&category=technology
Response Format
JSON
Authentication
Required
Rate Limited
1800 Credits
per 15 min (Paid Plans)
Request Parameters
Below are the request parameters available to filter and customise your API query.
Please note, your API query must contain atleast one of these parameters:
['q','qInTitle','qInMeta','country','category','language','full_content','image','video','prioritydomain','domainurl'], Otherwise the API query won't work.
| Name | Required | Description | Default | Example |
|---|---|---|---|---|
Search & Content Filters | ||||
qInTitle | OPTIONAL | Search news articles for specific keywords or phrases present in the news titles only. The value must be URL-encoded and the maximum character limit permitted is 512 characters. Note: qInTitle can't be used with q or qInMeta parameter in the same query. | - | qInTitle=pizza |
qInMeta | OPTIONAL | Search news articles for specific keywords or phrases present in the news titles, URL, meta keywords and meta description only. The value must be URL-encoded and the maximum character limit permitted is 512 characters. Note: qInMeta can't be used with q or qInTitle parameter in the same query. | - | qInMeta=pizza |
q | OPTIONAL | Search news articles for specific keywords or phrases present in the news title, content, URL, meta keywords and meta description. The value must be URL-encoded and the maximum character limit permitted is 512 characters. | - | q=pizza |
id | OPTIONAL | Search the specific news article from its unique article_id string. You can add up to 50 article id strings in a single query or as per your specified limit. | - | id=article_id id=article_id_1,article_id_2, article_id_3 |
url | OPTIONAL | You can search for a specific news article by providing its URL. | - | url=https://newsdata.io/blog/multiple-api-key-newsdata-io |
category | OPTIONAL | Search the news articles for a specific category. Include up to 5 categories per query on Free and Basic plans. Professional and Corporate plans support up to 10 categories. | - | category=sports,top |
excludecategory | OPTIONAL | You can exclude specific categories to search for news articles. Exclude up to 5 categories per query on Free and Basic plans. Professional and Corporate plans support up to 10 categories. Note: You can use either the 'category' parameter to include specific categories or the 'excludecategory' parameter to exclude them, but not both simultaneously. | - | excludecategory=top |
datatype | OPTIONAL | Specifies the type of the article. Supported values: news, blog, multimedia, forum, pressrelease, review, research, opinion, analysis, podcast. Available for latest and market. Include up to 5 datatype per query on Free and Basic plans. Professional and Corporate plans support up to 10 datatype. | - | datatype=news,blog |
tag | OPTIONAL | Search the news articles for specific AI-classified tags. Include up to 10 tags per query. With Custom AI Tags (Corporate Yearly Plan only), you can request your own tag to classify articles based on your specific topic or tag | - | tag=food,tourism |
organization | OPTIONAL | Search the news articles related to specific organizations. Include up to 10 tags per query. (Available only Corporate users) | - | organization=uber,apple |
creator | OPTIONAL | Search by name of the article author or content creator. Include up to 5 creators per query on Free and Basic plans. Professional and Corporate plans support up to 10 creators. | - | creator=chintan haria creator=liz carolan,luca socci |
sentiment | OPTIONAL | Search the news articles based on the sentiment of the news article (positive, negative, neutral). | - | sentiment=positive |
Location, Language & Time Filters | ||||
country | OPTIONAL | Search news articles from specific countries. Include up to 5 countries per query on Free and Basic plans. Professional and Corporate plans support up to 10 countries. | - | country=au,jp |
excludecountry | OPTIONAL | Exclude news articles from specific countries. Include up to 5 countries per query on Free and Basic plans. Professional and Corporate plans support up to 10 countries. Note: You can use either the 'country' parameter to include specific countries or the 'excludecountry' parameter to exclude them, but not both simultaneously. | - | excludecountry=au,jp |
region | OPTIONAL | Search the news articles for specific geographical regions. The region could be a city, district, county, state, country, or continent. Include 5 regions per query, and it can be customized up to 10 regions per query. (Available only for Corporate users). | - | region=city1,city2 region=city1-state1-country1, city2-country2 region=state-country region=los angeles-california-usa region=new york,chicago |
language | OPTIONAL | Search the news articles for a specific language. Include up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages. | - | language=fr,en,ga |
excludelanguage | OPTIONAL | You can exclude specific languages to search for news articles. Exclude up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages. Note: You can use either the 'language' parameter to include specific languages or the 'excludelanguage' parameter to exclude them, but not both simultaneously. | - | excludelanguage=fr,en,ga |
timezone | OPTIONAL | Search the news articles for a specific timezone. You can add any specific timezone. | - | timezone=America/New_york timezone=Asia/Kolkata timezone=Asia/Qatar timezone=Europe/Berli |
from_date | OPTIONAL | Use from_date filter to get news data from a particular date in the past. Note: If you didn’t specify from_date then from_date will be considered as per your subscription plan. For example, if you have purchased the professional subscription plan and didn’t mention from_date then the API will automatically fetch the data from the past 1 year. | - | from_date=YYYY-MM-DD from_date=2025-01-01 from_date=YYYY-MM-DD HH:MM:SS from_date=2025-01-01 06:12:45 |
to_date | OPTIONAL | This filter is used to set an end date for the search result. Note: If you didn't specify to_date then the API will fetch the data till today | - | to_date=YYYY-MM-DD to_date=2025-01-30 to_date=YYYY-MM-DD HH:MM:SS to_date=2025-01-30 06:12:45 |
Source, Quality & Intelligence Controls | ||||
domainurl | OPTIONAL | Search the news articles for specific domains or news sources. Include up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains. Note: If the domain is incorrect, It will give suggestions in the response | - | domainurl=nytimes.com, bbc.com,bbc.co.uk |
excludedomainurl | OPTIONAL | You can exclude specific domains or news sources to search the news articles. Exclude up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains. Note: If the domain is incorrect, It will give suggestions in the response | - | excludedomainurl=nytimes.com, bbc.com,bbc.co.uk |
prioritydomain | OPTIONAL | Search the news articles only from top news domains. We have categorized prioritydomain in 3 categories. Top: Fetches news articles from the top 10% of the news domains Medium: Fetches news articles from the top 30% of the news domains. It means it already includes all the news articles of 'top' priority. Low: Fetches news articles from the top 50% of the news domains. It means it already includes all the news articles of 'top' and 'medium' priorities. | - | prioritydomain=top prioritydomain=medium prioritydomain=low |
sentiment_score | OPTIONAL | Filters articles by sentiment score. Returns only articles with a sentiment score greater than or equal to the specified value. Note: Works only when the sentiment parameter is enabled. | - | sentiment_score=70 |
image | OPTIONAL | Search the news articles with featured image or without featured image. Use 1 for articles with featured image and 0 for articles without featured image. | - | image=1 image=0 |
video | OPTIONAL | Search the news articles with videos or without videos. Use 1 for articles with videos and 0 for articles without videos. | - | video=1 video=0 |
full_content | OPTIONAL | Search the news articles with full content or without full content. Use '1' for news articles which contain the full_content response object and '0' for news articles which don't contain full_content response object. | - | full_content=1 full_content=0 |
removeduplicate | OPTIONAL | The 'removeduplicate' parameter will allow users to filter out duplicate articles. Use 1 to remove duplicate articles. (Note: The overall 'removeduplicate' parameter functioning works on the basis of Newsdata.io's internal algorithm. It doesn't imply that the article which has a 'removeduplicate=1' parameter is actually a duplicate article.) | - | removeduplicate=1 |
Request Control & Response Handling | ||||
apikey | Required | You need to add your API Key while accessing the newsdata API. | - | - |
sort | OPTIONAL | You can sort the search results based on your preferred criteria to organize how news articles appear in the response. You can use the sort parameter with one of the following options: pubdateasc – Sort articles by publish date in ascending order (oldest to newest). relevancy – Sort articles by most relevant results first based on your query. source – Sort results by source priority (top to low). fetched_at - Sort articles by their fetched date. Note: By default, results are sorted by publish date (newest first) if no sort parameter is specified. | - | sort=relevancy sort=fetched_at |
size | OPTIONAL | You can customize the number of articles you get per API request from 1 to 50. | Free user - 10 Paid user - 50 | size=25 |
page | OPTIONAL | Use page parameter to navigate to the next page. To know more, | - | - |
excludefield | OPTIONAL | you can limit the response object to search for news articles. You can exclude multiple response objects in a single query. Note: You cannot exclude article ID from the response field | - | excludefield=pubdate excludefield=source_icon, pubdate,link |
Example Queries
1. News from category technology and science
https://newsdata.io/api/1/archive?apikey=YOUR_API_KEY&category=technology,science
2. News from_date October 7, 2026 to October 20, 2026
https://newsdata.io/api/1/archive?apikey=YOUR_API_KEY&from_date=2026-10-07&to_date=2026-10-20&category=technology
3. News from September 21, 2026 till present date
https://newsdata.io/api/1/archive?apikey=YOUR_API_KEY&from_date=2026-09-21&category=science
See also
News Archive API EndpointWas this page helpful?