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.
/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
textoptionalQuery text to search events by. Use keywords or short phrases for best match results.
yearoptional4-digit year (e.g.
1776). For BC/BCE years, use a negative integer (e.g.-351for 351 BC).monthoptionalInteger month (e.g.
3for March).dayoptionalCalendar day of the month.
offsetoptionalpremium onlyNumber of results to offset pagination.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request Live Demo!
https://api.api-ninjas.com/v1/historicalevents?text=roman empireHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
[
{
"year": "-45",
"month": "01",
"day": "01",
"event": "The Julian calendar takes effect as the civil calendar of the Roman Empire, establishing January 1 as the new date of the new year."
},
{
"year": "366",
"month": "01",
"day": "02",
"event": "The Alemanni cross the frozen Rhine in large numbers, invading the Roman Empire."
},
{
"year": "250",
"month": "01",
"day": "03",
"event": "Emperor Decius orders everyone in the Roman Empire (except Jews) to make sacrifices to the Roman gods."
},
{
"year": "-27",
"month": "01",
"day": "16",
"event": "Gaius Julius Caesar Octavianus is granted the title Augustus by the Roman Senate, marking the beginning of the Roman Empire."
},
{
"year": "379",
"month": "01",
"day": "19",
"event": "Emperor Gratian elevates Flavius Theodosius at Sirmium to Augustus, and gives him authority over all the eastern provinces of the Roman Empire."
},
{
"year": "1719",
"month": "01",
"day": "23",
"event": "The Principality of Liechtenstein is created within the Holy Roman Empire."
},
{
"year": "98",
"month": "01",
"day": "27",
"event": "Trajan succeeds his adoptive father Nerva as Roman emperor; under his rule the Roman Empire will reach its maximum extent."
},
{
"year": "1018",
"month": "01",
"day": "30",
"event": "Poland and the Holy Roman Empire conclude the Peace of Bautzen."
},
{
"year": "421",
"month": "02",
"day": "08",
"event": "Constantius III becomes co-Emperor of the Western Roman Empire."
},
{
"year": "55",
"month": "02",
"day": "11",
"event": "The death under mysterious circumstances of Tiberius Claudius Caesar Britannicus, heir to the Roman empire, on the eve of his coming of age clears the way for Nero to become Emperor."
}
]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.