All About Market Endpoint In NewsData.io

In this article, we will focus on the Market News Endpoint of NewsData.io.

Market News Endpoint Of NewsData.io

Market News or Market endpoint provides you with the latest news articles related to financial news, stock market news, and business-related mergers. Get real-time market information and market analysis, along with financial sentiment analysis. 

This endpoint gives users access to the latest news articles in real-time. For Free users, the articles are delayed for 12 hours. ( This endpoint is currently in beta version)

The basic parameter to retrieve the market news is:

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

This parameter retrieves articles from the past 48 hours. Paid users will get 50 articles/request, and free users will get 10 articles/request.

After entering the API key, request parameters such as q, country, language, domain, etc., can also be added. 

Market News Extraction using “Market” Endpoint

1. Obtain API Key

You need to sign up for an account on NewsData.io and obtain an API key. 

2. Make Your Request

To request the Market News endpoint, you’ll use an HTTP client library (such as a request in Python) or a tool like Postman, and you can even access the data with the search query URL and use it in Chrome. The typical components of the API request include

a. Endpoint URL

The given URL can be used for this:

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

b. Request Method

For retrieving data, use the HTTP GET method.

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

c. Add Query

You need to add a query to your request.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=uber

NOTE: You can use multiple parameters, such as q, qInTitle, qInMeta, symbol, and timeframe, to fetch the required data. 

Request Parameter of Market News Endpoints

1. id

Search for news articles using its unique “article_id” string. You can include up to 50 such article id strings in a single query or as per your specified limit. 

For better understanding, below are some examples.

• If you set ‘id=b265095a0c35cac33d78fe03084afbe4, it will fetch you the article with the given unique article id.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&id=b265095a0c35cac33d78fe03084afbe4

2. q

Search news articles for specific keywords present anywhere in the entire article.

For example, q=microsoft will display all relevant articles that contain the keyword ‘microsoft’.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=microsoft

3. qInTitle

Search for specific keywords or phrases present in news titles among the fetched news articles. For example, qInTitle=uber will display all relevant articles that contain ‘uber’ in the news title.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&qInTitle=uber

4. qInMeta

Search the news articles from the URL, meta description, and title by using this parameter.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&qInMeta=money

Click here to learn more about the q, qInTitle, and qInMeta parameters.

5. Timeframe

You can search the articles by using specific timeframes.

• The timeframe can be set between 1-48 hours.
• The timeframe can also be set in the minutes range, which is 1-2880 minutes.

Note: You can only use one timeframe at a time.

For example, if we set ‘timeframe=10’, it will show the articles from the past 10 hours only.

https://newsdata.io/api/1/markett?apikey=YOUR_API_KEY&q=microsoft&timeframe=10

6. Country

Search the news articles from a specific country.

For example, ‘country=us’, where us means the United States.

The given request will fetch the articles related to ‘query=elon musk’ from the United States.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=elon musk&country=us

7. Symbol

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.

For example, ‘symbol=AAPL’, where us means the United States.

The given request will fetch the articles related to ‘symbol=AAPL’ from the United States.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&symbol=AAPL

8. Language

Search the news articles for a specific language.

For example, ‘language=en’, where en means English.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=amazon&language=en

The given request will fetch only those articles that are in English.

NOTE: You can add up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages.

9. Tag

This parameter helps search the news articles for specific AI-classified tags. This parameter allows you to search for articles beyond the keywords and seek AI’s help to enhance the data extraction.

Some of the ai_tags are ‘Banking and Financial services’, ‘markets’, ‘Economy’, ‘real estate’, etc. You can add up to 5 AI tags in a single query. For example, tag=real estate, banking. 

The query will fetch only those articles that have the ‘banking’ and ‘real estate’ tags.

https://newsdata.io/api/1/market?apikey=pub_YOUR_API_KEY&tag=realestate,banking

Note: You can include up to 10 tags per query. (Available only for Professional and Corporate users).

10. Sentiment

Search the news articles based on the sentiment of the news article. The sentiments are divided into three categories, namely, ‘positive’, ‘neutral’, and ‘negative’ sentiment. This parameter screens the articles individually and analyzes the tone and opinion expressed in the articles. This parameter helps enhance the user experience and narrow done the data being extracted.

For example, sentiment=positive.

https://newsdata.io/api/1/market?apikey=pub_YOU API KEY&q=amazon&sentiment=positive

This query will fetch those articles about Amazon that showcase positive sentiment only.

11. Organization

This parameter helps search for news articles from a specific organization. It includes up to 10 organizations per query.

(Available only to Corporate users)

For example,organization=uber, apple

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&organization=uber,apple

12. Domain

Search the news articles of specific news domains, such as the BBC or the New York Times.

For example, ‘domain=bbc.com’

NOTE: In case you inserted the wrong domain name, the request will fail, and you will see suggestions for the domain you might be searching for.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&domain=bbc

The given request would fetch the articles that contain the keyword ‘Money’, which is from the BBC domain only.

NOTE: You can add up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains.

13. Domainurl

Allows users to extract articles from news domains.

For example, domainurl=bbc.com

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&domainurl=bbc.com

The given request would fetch the articles that contain the keyword ‘money’ from the BBC domain only. 

NOTE: You can add up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains.

NOTE: If you enter the wrong domain URL, the system will display an error and suggest the correct domain URL (s). You can then choose the correct domainurl(s) and continue data fetching.

14. Exclude Domain

You can exclude the domains you don’t want articles from, using this parameter.

For example, ‘excludedomain=bbc.com’

The given request would fetch the articles that contain the keyword ‘money’, excluding the bbc domain. 

Note: You can exclude up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains.

15. Excludefield

You can exclude the response object field you don’t want to be fetched regarding news articles, using this parameter.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=tesla&excludefield=pubdate

For example, ‘excludefield=pubdate’

The given request would fetch the articles that don’t contain the ‘Publish Date’ field of response objects.

16. Domain Priority

This allows users to extract news articles based on the domain authority of news sources.

There are three priority levels:

Top: Fetches news articles from the top 10% of the news domains. The request parameter is ‘prioritydomain=top’.

https://newsdata.io/api/1/markett?apikey=pub_YOUR_API_KEY&q=tesla&prioritydomain=top

Medium: Fetches news articles from the top 30% of the news domains. The request parameter is ‘prioritydomain=medium’.

https://newsdata.io/api/1/market?apikey=pub_YOUR_API_KEY&q=nike&prioritydomain=medium

Low: Fetches news articles from the top 50% of the news domains. The request parameter is ‘prioritydomain=low’.

https://newsdata.io/api/1/market?apikey=pub_YOUR_API_KEY&q=money&prioritydomain=low

17. Timezone

You can search the articles based on specific time zones.

The request parameter for the time zone would be ‘timezone=Asia/Dubai’.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=facebook&timezone=Asia/Dubai

18. Full Content

You can request a full-content article or a full-content article using this parameter.

The request parameter would be ‘full_content=1’ for full content and ‘full_content=0’ for content that doesn’t contain full-width content.

• For full content

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=tesla&full_content=1

19. Image

This parameter allows you to search for articles with or without featured images.

The request parameter would be ‘image=1’ for articles with featured images and ‘image=0’ without featured images.

• For articles with featured images

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=microsoft&image=1

• For articles without featured images

https://newsdata.io/api/1/markett?apikey=YOUR_API_KEY&q=microsoft&image=0

20. Video

This parameter would help users retrieve articles containing videos.

The request parameter would be ‘video=1’ for articles with video and ‘video=0’ for those without video.

For articles with video

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=modi&video=1

For articles without video

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=modi&video=0

21. Removeduplicate

This parameter would help users to remove duplicate articles. The request parameter to remove duplicate articles would be ‘removeduplicate=1′

https://newsdata.io/api/1/markett?apikey=YOUR_API_KEY&q=modi&removeduplicate=1

NOTE: The article with the ‘removeduplicate=1’ parameter doesn’t necessarily mean that the article is a duplicate article; this parameter is based on Newsdata.io’s internal algorithm.

22. Size

This allows users to customize the number of articles that can be fetched per API request.

For free users, the maximum limit is 10, while it is up to 50 for paid users.

The parameter for this request would be size=25.

This request will fetch 30 articles/requests, but only for paid users because their max limit is up to 50.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&size=30

This request will fetch 10 articles/requests for free and paid users, respectively.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&size=10

NOTE: If free users try to fetch more than the limit, then the request will fail, and an error will be displayed.

23. Page

This parameter allows the user to navigate to the next page. While fetching the data, you will see a ‘nextPage’ string at the bottom of the screen. You can insert this in your query in order to navigate to the next page manually.

For example,

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=YOUR_QUERY&page=XXXPPPXXXXXXXXXX

This parameter will take you to the next page with a set of new articles.

To learn more about this parameter, click here.

24. excludelanguage

With this parameter, you can exclude specific languages from the search for news articles. You can exclude up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages.

For Example: excludelanguage=fr, en

Note: You can use either the ‘language’ parameter to include specific languages or the ‘excludelanguage’ parameter to exclude them, but not both simultaneously.

25. Sort

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 the most relevant results first based on your query.

Source – Sort results by source priority (top to low).

Example: sort=relevancy

Note: By default, results are sorted by publish date (newest first) if no sort parameter is specified.

26. url

You can search for a specific news article by providing its URL. It fetches details of that particular article directly.

Example: url=https://newsdata.io/blog/multiple-api-key-newsdata-io

27. Exclude country

With the excludecountry parameter, you can exclude news articles from specific countries to refine your search results. It will provide results according to your requirements and exclude all selected countries.

NOTE: You can exclude up to 5 countries per query on Free and Basic plans. Professional and Corporate plans support excluding up to 10 countries. 

28. from_date 

This parameter uses the 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.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&from_date=2025-01-01 06:12:45

For example, if you have purchased the professional subscription plan and didn’t specify from_date, then the API will automatically fetch the data from the past 1 year.

29. to_date

This parameter is used to set an end date for the search result.

https://newsdata.io/api/1/market?apikey=YOUR_API_KEY&q=money&to_date=2025-01-30 06:12:45

Note: If you didn’t specify a to_date, then the API will fetch the data up to today.

For more information, please refer to the documentation.