idstringOptional
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. (Example: id=article_id id=article_id_1,article_id_2,article_id_3)
qstringOptional
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. Please refer Advanced Search for more details (Example: q=pizza)
qInTitlestringOptional
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. (Example: qInTitle=pizza)
qInMetastringOptional
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. (Example: qInMeta=pizza)
sizeintegerOptional
You can customize the number of articles you get per API request from 1 to 50. (Example: size=25)
timeframestringOptional
Search the news articles for a specific timeframe (Minutes and Hours). For hours, you can set a timeframe of 1 to 48, and for minutes, you can define a timeframe of 1m to 2880m. For example, if you want to get the news for the past 6 hours then use timeframe=6 and if you want to get news for the last 15 min then use timeframe=15m.Note - You can only use timeframe either in hours or minutes. (Example: For Hours -timeframe=1timeframe=6timeframe=24For Minutes -timeframe=15mtimeframe=45mtimeframe=90m)
countrystringOptional
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.Check the codes for all the countries here. (Example: country=au,jp)
excludecountrystringOptional
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.Check the codes for all the countries here.Note: You can use either the 'country' parameter to include specific countries or the 'excludecountry' parameter to exclude them, but not both simultaneously. (Example: excludecountry=au,jp)
categorystringOptional
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.Check the codes for all the categories here. (Example: category=sports,top)
excludecategorystringOptional
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. (Example: excludecategory=top)
languagestringOptional
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. Check the codes for all the languages here. (Example: language=fr,en)
excludelanguagestringOptional
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. (Example: excludelanguage=fr,en)
sortstringOptional
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).Note: By default, results are sorted by publish date (newest first) if no sort parameter is specified. (Example: sort=relevancy)
urlstringOptional
You can search for a specific news article by providing its URL. (Example: url=https://newsdata.io/blog/multiple-api-key-newsdata-io)
tagstringOptional
Search the news articles for specific AI-classified tags. Include up to 10 tags per query. (Available only for Professional and Corporate users)Check the codes for all the AI tags here.With Custom AI Tags (Corporate Yearly Plan only), you can request your own tag to classify articles based on your specific topic or tag (Example: tag=food,tourism)
sentimentstringOptional
Search the news articles based on the sentiment of the news article (positive, negative, neutral).(Available only for Professional and Corporate users) (Example: sentiment=positive)
organizationstringOptional
Include up to 10 organizations per query. (Available only Corporate users) (Example: organization=uber,apple)
regionstringOptional
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). Check out NewsData.io Region blog for practical understanding. (Example: region=city1,city2 region=city1-state1-country1,city2-country2 region=state-country region=los angeles-california-usa region=new york,chicago)
domainstringOptional
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. You can check the name of the domains here (Example: domain=nytimes,bbc)
domainurlstringOptional
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 (Example: domainurl=nytimes.com,bbc.com,bbc.co.uk)
excludedomainstringOptional
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 (Example: excludedomain=nytimes.com,bbc.com,bbc.co.uk)
excludefieldstringOptional
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 articles response field in the object (Example: excludefield=pubdateexcludefield=source_icon,pubdate,link)
prioritydomainstringOptional
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. (Example: prioritydomain=topprioritydomain=mediumprioritydomain=low)
timezonestringOptional
Search the news articles for a specific timezone. You can add any specific timezone. You can check the timezone here (Example: timezone=America/New_yorktimezone=Asia/Kolkatatimezone=Asia/Qatartimezone=Europe/Berli)
full_contentstringOptional
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. (Example: full_content=1full_content=0)
imagestringOptional
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. (Example: image=1image=0)
videostringOptional
Search the news articles with videos or without videos. Use 1 for articles with videos and 0 for articles without videos. (Example: video=1video=0)
removeduplicatestringOptional
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.) (Example: removeduplicate=1)
pageintegerOptional
Use page parameter to navigate to the next page. To know more: click here
coinstringOptional
Search the news articles for a specific language. Include up to 5 coins per query on Free and Basic plans. Professional and Corporate plans support up to 10 coins (Example: coin=btc coin=eth,usdt,bnb)
symbolstringOptional
Search market news articles related to specific stock symbols or tickers. You can add up to 5 tickers in a single query. Professional and Corporate plans support up to 10 symbols. (Example: symbol=AAPLsymbol=AAPL,TSLA,MSFT)
namestringOptional
The name of the domain (As defined by the NewsData.io moderators).
