Options
Specify Sources
When making a news data API request, you can filter down your results by news sources. To do that you will need to attach the sources parameter to your API request URL and set it to one or multiple news source values. As you can see in the example below, it is also possible to exclude specific news sources by prepending them with a - symbol.
Example API Request:
Sign Up to Run API request
Example API Response: Need to see how an API response looks like? Jump to one of our example API responses above.
Specify Categories
You can also filter news articles by category. To do this, simply attach the API's categories parameter and set it to one or multiple comma-separated values. As with other parameters, you can also exclude categories by prepending a - symbol.
Available News Categories:
general- Uncategorized Newsbusiness- Business Newsentertainment- Entertainment Newshealth- Health Newsscience- Science Newssports- Sports Newstechnology- Technology News
Example API Request:
Sign Up to Run API Request
Example API Response: Need to see how an API response looks like? Jump to one of our example API responses above.
Specify Countries
You can also filter news articles by country. To do this, simply attach the API's countries parameter and set it to one or multiple comma-separated 2-letter country codes. As with other parameters, you can also exclude countries by prepending a - symbol. You can browse all supported countries here.
Example API Request:
Example API Response: Need to see how an API response looks like? Jump to one of our example API responses above.
Specify Languages
You can also filter news articles by language. To do this, simply attach the API's languages parameter and set it to one or multiple comma-separated 2-letter language codes. As with other parameters, you can also exclude languages by prepending a - symbol.
Available Languages:
ar- Arabicde- Germanen- Englishes- Spanishfr- Frenchhe- Hebrewit- Italiannl- Dutchno- Norwegianpt- Portugueseru- Russianse- Swedishzh- Chinese
Example API Request:
Example API Response: Need to see how an API response looks like? Jump to one of our example API responses above.
Search Keywords
To narrow down your search for articles even more, you can specify one or multiple comma-separated search keywords. As with other parameters, you can also exclude keywords by prepending a - symbol. Find a few clarifications about this parameter below.
Clarifications:
& keywords = food industry- Search for keyword "food industry"& keywords = food industry, meat- Search for keywords "food industry" and "meat"& keywords = food industry, -meat- Search for keywords "food industry", but exclude "meat"& keywords = -food industry, -meat- Search for all news, excluding "food industry" and "meat"& keywords = a-plus- Search for keyword "a-plus"& keywords = a, -plus- Search for keyword "a", but exclude "plus"
Example API Request:
Example API Response: Need to see how an API response looks like? Jump to one of our example API responses above.