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

---

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