January Sale! Get over 30% off when you subscribe to an annual plan!

Historical Events API

The Historical Events API allows you to search for famous events in history. From ancient antiquity to modern times, events from all parts of human civilization are recorded.

(4.3)

From 10,001 users

3,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
341ms362ms403ms731ms1067ms

Didn't find what you were looking for? Suggest an improvement

/v1/historicalevents GET

https://api.api-ninjas.com/v1/historicalevents

Returns a list of up to 10 events that match the search parameters. Use the offset parameter to paginate through more results.

Parameters

  • text  optional

    Query text to search events by. Use keywords or short phrases for best match results.

  • year  optional

    4-digit year (e.g. 1776). For BC/BCE years, use a negative integer (e.g. -351 for 351 BC).

  • month  optional

    Integer month (e.g. 3 for March).

  • day  optional

    Calendar day of the month.

  • offset  optional premium only

    Number of results to offset pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of historical event objects, each containing:

  • year

    The year of the event. For BC/BCE years, this is a negative integer (e.g., "-45" for 45 BC).

  • month

    The month of the event as a 2-digit string (e.g., "01" for January).

  • day

    The day of the month as a 2-digit string.

  • event

    Description of the historical event.

Sample Request Live Demo!

text
year
month
day
offset premium

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/historicalevents?text=roman%20empire

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/historicalevents?month=1&day=1" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.