Sources endpoint provides names of randomly selected 100 domains from a country, category or/and language. It is mainly a convenience endpoint that you can use to keep track of the publishers available on the API.
Resource URL
https://newsdata.io/api/1/sources?apikey=YOUR_API_KEY
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.
| Name | Required | Description | Default | Example |
|---|---|---|---|---|
Search & Content Filters | ||||
category | OPTIONAL | Search the news sources 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 |
Location, Language & Time Filters | ||||
country | OPTIONAL | Search news sources 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 |
language | OPTIONAL | Search the news sources 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 |
Source, Quality & Intelligence Controls | ||||
domainurl | OPTIONAL | Search 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 |
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 |
Request Control & Response Handling | ||||
apikey | Required | You need to add your API Key while accessing the newsdata API. | - | - |
Example Queries
1. News sources that show from specific country
https://newsdata.io/api/1/sources?apikey=YOUR_API_KEY&country=ua
2. News sources that show from specific category
https://newsdata.io/api/1/sources?apikey=YOUR_API_KEY&category=politics
3. News sources that show from specific language
https://newsdata.io/api/1/sources?apikey=YOUR_API_KEY&language=nl
See also
News Sources EndpointsWas this page helpful?