Developer first News API
Use the Hyper News API to find the latest news headlines and historical news data from publishers around the world where we Index 1 Million + articles each day in dozens of different languages.
We offer a high performance modern API to individuals, small and large businesses.
Our Modern API is lightweight with low latency and at a market leading low price.
Endpoints
Environment | URL |
---|---|
Production | https://api.hypernewsapi.com |
Authentication
News API must authenticate using either a HTTP header or Query Parameter for authentication. Your API Key will be provided upon signing up to Hyper News. A new api key will be issued if you change account plans.
Header Example:
X-API-Key: 3f0ag9e162604c598c34d6522d0bdf20=
Query Parameter Example:
https://api.hypernewsapi.com/api/Publishers?api-key={{API_KEY}}
The Hyper News API has a rate limit of 1,000 calls per minute for paid plans combined with your specific monthly quota depending on your chosen subscription plan.
Rate Limit
The current Rate Limit remaining will be returned as a header on each api-call response.
X-RateLimit-Remaining: 1000
Once the rate limit is excedded you will recieve the following header. Specifying the amount of time in seconds till you can make your next request.
Retry-After: 200
You will also recieve a response body which will specify the amount of time till you can make your next request.
{
"statusCode": "429,",
"message": "Rate limit is exceeded. Try again in 40 seconds."
}
Monthly Quota
Once the monthly quota is reached a header will be returned with the total amount of time remaining till the quota resets in seconds.
Retry-After: 200
You will also recieve a response body which will specify the amount of time till the quota resets.
{
"statusCode": 403,
"message": "Out of call volume quota. Quota will be replenished in 02:17:53."
}
*Note: The total monthly quota will be added to the dashboard in a future software update as apart of the development roadmap.
Paging of Results
Pagination is handled using the size
and page
parameters. The page
attribute represents the current page of results. size
is the maximum number of entries to return in the response.
Pagination Example Object
{
"Articles": [
{...}
],
"CurrentPage": 2,
"TotalPages": 13,
"PageSize": 1
}
Attributes
Attribute | Type | Notes |
---|---|---|
CurrentPage | int | Current Page |
TotalPages | int | Total number of pages avaliable to page through |
PageSize | int | Number of results on the returned page |