Note that you can bypass reading this document if you use the Newsomatic plugin<\/a> together with this API. You should read this document only if you will create your own implementation of the code that will use this API. If this is the case, lets get started!<\/p>\n NewsomaticAPI is a simple HTTP REST API for searching and retrieving live articles from all over the web. It can help you answer questions like:<\/p>\n You can search for articles with any combination of the following criteria:<\/p>\n You can sort the results in the following orders:<\/p>\n You need an API key to use the API – this is a unique key that identifies your requests. You can get an API key here<\/a> (you will need a purchase code for the Newsomatic plugin<\/a>). If you use this API key, you will have a 500 API call\/day limit. If you wish to get more, you need to subscribe NewsomaticAPI on RapidAPI<\/a>.<\/p>\n If you create an API key based on a purchase code of the Newsomatic plugin, authentication is handled with a simple API key. You can attach your API key to a request in this simple way: via the apikey<\/em> <\/strong>query string parameter. In this case, you will not need to use the apikey URL parameter to send your API key, but the API key needs to be sent using the above header.<\/p>\n We strongly recommend the either of last two so that your API key isn’t visible to others in logs or via request sniffing.<\/p>\n If you create an API key based on a purchase code of the Newsomatic plugin, the base URL of the API will be:<\/p>\n If you subscribe to NewsomaticAPI on RapidAPI, the base URL of the API will be:<\/p>\n NewsomaticAPI has 3 main endpoints:<\/p>\n Examples of the above endpoints:<\/p>\n There is also a minor endpoint that can be used to retrieve a small subset of the publishers we can scan:<\/p>\nGeneral Info<\/h2>\n
\n
\n
\n
API Keys<\/h2>\n
If you are using a subscription to NewsomaticAPI from RapidAPI, you will need to pass the following headers to your request:<\/p>\n\n
API Base URLs<\/h2>\n
https:\/\/newsomaticapi.com\/apis\/news\/v1
\n<\/code><\/p>\nhttps:\/\/newsomaticapi.p.rapidapi.com
\n<\/code><\/p>\nEndpoints<\/h2>\n
\n
\/all<\/code> \u2013 search every article published by over 2,500 different sources large and small in the last 60 days.<\/li>\n\/top<\/code> \u2013 returns breaking news headlines for countries, categories, and singular publishers.<\/li>\n\/sources<\/code> \u2013 returns information (including name, description, and category) about all the sources available for searching.<\/li>\n<\/ul>\n\n
https:\/\/newsomaticapi.com\/apis\/news\/v1\/all<\/code><\/li>\nhttps:\/\/newsomaticapi.p.rapidapi.com\/all<\/code><\/li>\n<\/ul>\nExample request (using the 500 API request\/day API key):<\/h2>\n