The Market News endpoint provides access to the latest and most relevant financial news, stock market news, and business-related news.
It aggregates news related to financial publications, market reports, company earnings announcements, policy updates, and macroeconomic coverage, all focused exclusively on the global markets ecosystem.
With the Market endpoint, you can access curated financial news from thousands of verified sources, filtered by tickers, sectors, market categories, and sentiment.
Resource URL
https://newsdata.io/api/1/market?apikey=YOUR_API_KEY
Response Format
JSON
Authentication
Required
Rate Limited
1800 Credits
per 15 min (Paid Plans)
Find Market Identifier
Search for any publicly listed company worldwide to get its unique Market Id for the 'market_id' parameter.
About Market Identifier
Each publicly listed company is assigned a globally unique Market ID by NewsData.io in the format TICKER-COUNTRY-EXCHANGE (e.g., AAPL-US-NASDAQ).
Unlike stock tickers, which can be duplicated across different exchanges and countries, a Market ID uniquely identifies a company worldwide.
Use the Market Identifier as the value of the ‘market_id’ parameter.
| Company | Ticker | Exchange | Market ID |
|---|---|---|---|
| Apple Inc. | AAPL | NASDAQ (US) | AAPL-US-NASDAQ |
| Tesla Inc. | TSLA | NASDAQ (US) | TSLA-US-NASDAQ |
| Reliance Ind. | RELIANCE | NSE (IN) | RELIANCE-IN-NSE |
Request Parameters
Below are the request parameters available to filter and customise your API query.
| 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 |
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. | - | tag=IPO |
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 |
Indices
(Coming soon) | OPTIONAL | Filter news articles related to specific stock market indices. Include up to 5 indices per query on Free and Basic plans. Professional and Corporate plans support up to 10 indices. | - | indices=SP500,NIKKEI225,FTSE100 |
market_id | Optional | Filter market news by one or more NewsData.io Market IDs. NewsData.io assigns each publicly listed company a globally unique Market ID in the format TICKER-COUNTRY-EXCHANGE (e.g., AAPL-US-NASDAQ). This unique identifier ensures accurate company matching across global stock exchanges, even when the same ticker exists on multiple exchanges. Find the correct market_id by searching with a company name or stock ticker (e.g., Apple or AAPL) using the You can specify up to 5 market IDs in a single request. Professional and Corporate plans support up to 10 market IDs. | market_id=AAPL-US-NASDAQ market_id=AAPL-US-NASDAQ,TSLA-US-NASDAQ,RELIANCE-IN-NSE | |
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 |
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 |
timeframe | OPTIONAL | 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. | - | For Hours - timeframe=1 timeframe=6 timeframe=24 For Minutes - timeframe=15m timeframe=45m timeframe=90m |
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. Organization-Specific News for Uber and Microsoft
https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&organization=uber,microsoft
2. Positive sentiment market news for stock tickers Microsoft and Google
https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&symbol=MSFT,GOOGL&sentiment=positive
3. Market news for stock tickers Apple and Tesla
https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&symbol=AAPL,TSLA
See also
Market News API EndpointWas this page helpful?