Changelog

Today, we're adding a parameter "domainurl" in the "Sources" endpoint. This parameter allows users to retrieve detailed source information for a specific domain.

Starting today, we're introducing two new response objects fields:

coin: This new response object field provides the symbol of the cryptocurrencies mentioned in the article. It is exclusively available in the Crypto endpoint.

pubDateTZ: The pubDateTimezone response object field will provide the time zone of the publication date mentioned in the news article. This response object field is available in the Latest/News, Crypto, and Archive endpoints.

Today, We're thrilled to announce that we have launched 1 new response object and 1 new parameter in the "latest" and "crypto" endpoints.

Response Object

duplicate - This response object will help identify whether the article is duplicate or not.

duplicate = false: This indicates that the article is recognized as unique.

duplicate = true: This signifies that the article is identified as a duplicate of an article already present.

New Parameter

The "removeduplicate" parameter will allow users to filter out duplicate articles, ensuring that users receive only unique articles, enhancing the overall user experience.

(Note: The mentioned response object and parameter functioning works on the basis of Newsdata.io's internal algorithm. It doesn’t imply that the article which has a duplicate is actually a duplicate article.)

Today, We're thrilled to announce that our corporate plans now come up with one new response field in the "Latest" endpoint.

Starting today, the result will include "ai_org" as an additional field in the response object.

ai_org: This response field will provide the AI-classified name of the organizations mentioned in the article. It is now available in the latest endpoint, offering a new level of detail and enhanced insights.

Today, We're changing the name of our "news" endpoint to "latest" endpoint. Both endpoints will remain functional ensuring uninterrupted access to our news data. Additionally, we will deprecate our "news" endpoint in a year, and the "latest" endpoint will remain operational.

Users can access the “latest” endpoint using the following URL:

https://newsdata.io/api/1/latest?apikey=YOUR_API_KEY

Today, We're adding the "excludefield" parameter in the "news", "archive" and "crypto" endpoint. This addition allows users to limit which response object they want and which they want to avoid

Today, We're adding the "excludecategory" parameter in the "news" and "archive" endpoint. This addition allows you to exclude up to 5 specific categories from your searches, refining your results to meet your needs better.

Today, we're adding a parameter "id". Starting today, you can search for any specific article by using its unique "article_id".

Today, we are delighted to announce that Crypto Endpoint now supports crypto coin news tracking. Starting today, you can use the 'coin' parameter to track any crypto coin news.

We are removing the following parameters from Crypto Endpoint. Effective immediately, the following parameters are no longer supported in the Crypto Endpoint.

• Country
• Category
• Region

Today, We're adding 2 new response objects. Starting today, your result will include the following response objects:

source_url: We've introduced the source_url response object to provide the URL of the source from which the news article originated.

source_icon: The source_icon response object has been added, allowing you to retrieve the logo associated with the news source.

Today, We're thrilled to announce that our corporate plan now come with 1 new response object and 1 new parameter in the "news" endpoint.

Response Object

Starting today, the result will include the following response object.

ai_region: This response object will provide the AI-classified regional information for a specific geographical understanding of news articles. ai_region could be a city, district, county, state, country, or continent.

New Parameters

region: This parameter allows you to retrieve news articles based on city, district, county, state, country, or continent.

Effective from January 15, 2024, the following adjustments will be made to the free plan:

Latest News Delay: Latest news updates will be delayed by 12 hours for free plan users.

Content: Full content will no longer be included in the response results for free plan users.

Timeframe Parameter: The "timeframe" parameter will be removed from the free plan.

To continue enjoying uninterrupted, real-time news updates, we encourage you to consider upgrading to one of our premium plans. Upgrade Now

Today, We're thrilled to announce that our professional and corporate plans now come with 2 new parameters in the "news" endpoint.

New Parameters

tag: This enhancement allows you to retrieve news articles based on their AI tag. For instance, specifying "tag=food,diseases" will retrieve articles related to food and diseases tags. You can add up to 5 tags in a single query. You can check the code for all the tags here.

sentiment: This parameter allows you to retrieve news articles based on the overall sentiment of the news article (positive, negative, neutral) For instance, specifying "sentiment=positive" will retrieve only positive sentiment articles.

Today, We're thrilled to announce that our professional and corporate plans now come with 3 additional response objects. Starting today, the result will include the following response objects:

Response Object

ai_tag: We've implemented advanced AI-based classification for news articles. Using machine learning, each article is now tagged into 85 categories, offering a more granular understanding of the content.

sentiment: This will provide the overall sentiment of each news article. Sentiments are categorized as positive, negative, or neutral.

sentiment_stats: This will provide the sentiment distribution of each news article. Track the ratio of positive, negative, and neutral sentiments of each news article.

Today, we're adding 1 new response object "source_priority". Starting today, your response will include source_priority, which shows the rank of news domains on the basis of their traffic and authenticity. The lower the source priority, the more authentic the domain.

Today, we're adding a parameter "prioritydomain" in the News "Sources" endpoint. This enhancement allows you to retrieve a list of News sources based on their credibility by utilizing the "prioritydomain" parameter. For instance, specifying "prioritydomain=top" will retrieve 100 news sources that rank within the top 10% of all available sources.

Today, We're updating the 'timeframe' parameter in the "news" and "crypto" endpoint, now users can search the news articles for a specific time frame in minutes. You can define the timeframe in minutes from 1m to 2880m.

Today, we're adding 1 new response object "article_id". Starting today, your response will include article_id, which is the unique id of each article.

Today, we're launching 1 new parameter "qInMeta". Along with "q" and "qInTitle" we are launching one more query parameter to let our users get more news compared to "qInTitle" and much more relevancy compared to "q" parameters.

"qInMeta": 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 either q or qInTitle parameters in the same query.

Difference between "q", "qInTitle" and "qInMeta"

"qInTitle" searches the keywords/phrases only in the Title of the news articles.

"qInMeta" searches the keywords/phrases in Title, URL, meta description and meta keywords of the news articles.

"q" searches the keywords/phrases in everything like Title, URL, meta description, meta keywords and full content of the articles.

Today, We're updating the Archive Endpoint. Starting today, your query must include one of these parameters: ['q', 'qintitle', 'domain', 'country', 'category', 'language', 'full_content', 'image', 'video', 'prioritydomain', 'domainurl'], otherwise your API query will not work.

Today, we have increased the historical data access in the Professional and Corporate Plans. Corporate users can now access 2 years of historical data, while Professional users can access 1 year of historical data.

Today, we're launching 8 new parameters and updating 1 parameter.

We are launching the following parameter today to further improve upon the Newsdata API experience:

• size: Now users can customize the number of articles they get per page or per request from 1 to 50.
• timeframe: In “News'' endpoint, now users can search the news articles for a specific hourly time frame. You can define the timeframe from 1 to 48.
• excludedomain: Now users can exclude specific domains while searching the news articles.
• prioritydomain: Search the news articles only from top news domains. We have categorized prioritydomain into 3 categories namely top, medium, and low.
• timezone: Search the news articles for a specific timezone.
• full_content: Search the news articles with full content or without full content.
• image: Search the news articles with featured images or without featured images.
• video: Search the news articles with videos or without videos.

Updated Parameter

• domain: domain parameter is now changed to domainurl. Now users can search news articles for specific domains or news sources. If the domain is incorrect, It will give suggestions in the response.