Historical events, births and deaths on a date
Events, births, deaths or holidays on a date (default: today).
Request
GEThttps://wikipedia-search.p.apihiver.com/v1/on-this-day?limit=2
Number. Default: today (1–12).
Number. Day of the month (default: today) (1–31).
String. events, births, deaths, holidays or selected (default
events). String. Wikipedia language code, e.g.
en, hi, mr, ta (default en). Number. Maximum number of results (1–100, default
20). Language
Client
1curl --request GET \
2 --url 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2' \
3 --header 'Accept: application/json' \
4 --header 'X-API-Key: YOUR_API_KEY'Historical events, births and deaths on a date: Wikipedia Search API reference
Events, births, deaths or holidays on a date (default: today). This endpoint is part of the Wikipedia Search API: Search Wikipedia in 300+ languages, get article summaries with images, 'on this day' events, random articles and autocomplete.
Historical events, births and deaths on a date: example requests in every language
GET /v1/on-this-day in Shell (cURL)
curl --request GET \
--url 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2' \
--header 'Accept: application/json' \
--header 'X-API-Key: YOUR_API_KEY'GET /v1/on-this-day in Shell (HTTPie)
http GET 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2' \
Accept:application/json \
X-API-Key:YOUR_API_KEYGET /v1/on-this-day in Shell (Wget)
wget --quiet \
--method GET \
--header 'Accept: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--output-document \
- 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2'GET /v1/on-this-day in Node.js (http)
const http = require('https');
const options = {
method: 'GET',
hostname: 'wikipedia-search.p.apihiver.com',
port: null,
path: '/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2',
headers: {
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on('data', function (chunk) {
chunks.push(chunk);
});
res.on('end', function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();GET /v1/on-this-day in Node.js (Request)
const request = require('request');
const options = {
method: 'GET',
url: 'https://wikipedia-search.p.apihiver.com/v1/on-this-day',
qs: {month: '{month}', day: '{day}', type: '{type}', lang: '{lang}', limit: '2'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});GET /v1/on-this-day in Node.js (Unirest)
const unirest = require('unirest');
const req = unirest('GET', 'https://wikipedia-search.p.apihiver.com/v1/on-this-day');
req.query({
month: '{month}',
day: '{day}',
type: '{type}',
lang: '{lang}',
limit: '2'
});
req.headers({
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
});
req.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.body);
});GET /v1/on-this-day in Node.js (Axios)
const axios = require('axios').default;
const options = {
method: 'GET',
url: 'https://wikipedia-search.p.apihiver.com/v1/on-this-day',
params: {month: '{month}', day: '{day}', type: '{type}', lang: '{lang}', limit: '2'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/on-this-day in Node.js (Fetch)
const fetch = require('node-fetch');
const url = 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2';
const options = {
method: 'GET',
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/on-this-day in JavaScript (XMLHttpRequest)
const data = null;
const xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener('readystatechange', function () {
if (this.readyState === this.DONE) {
console.log(this.responseText);
}
});
xhr.open('GET', 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2');
xhr.setRequestHeader('Accept', 'application/json');
xhr.setRequestHeader('X-API-Key', 'YOUR_API_KEY');
xhr.send(data);GET /v1/on-this-day in JavaScript (Axios)
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://wikipedia-search.p.apihiver.com/v1/on-this-day',
params: {month: '{month}', day: '{day}', type: '{type}', lang: '{lang}', limit: '2'},
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/on-this-day in JavaScript (Fetch)
const url = 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2';
const options = {
method: 'GET',
headers: {Accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY'}
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}GET /v1/on-this-day in JavaScript (jQuery)
const settings = {
async: true,
crossDomain: true,
url: 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2',
method: 'GET',
headers: {
Accept: 'application/json',
'X-API-Key': 'YOUR_API_KEY'
}
};
$.ajax(settings).done(function (response) {
console.log(response);
});GET /v1/on-this-day in Python (http.client)
import http.client
conn = http.client.HTTPSConnection("wikipedia-search.p.apihiver.com")
headers = {
'Accept': "application/json",
'X-API-Key': "YOUR_API_KEY"
}
conn.request("GET", "/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))GET /v1/on-this-day in Python (Requests)
import requests
url = "https://wikipedia-search.p.apihiver.com/v1/on-this-day"
querystring = {"month":"{month}","day":"{day}","type":"{type}","lang":"{lang}","limit":"2"}
headers = {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())GET /v1/on-this-day in PHP (cURL)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: application/json",
"X-API-Key: YOUR_API_KEY"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}GET /v1/on-this-day in PHP (Guzzle)
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2', [
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY',
],
]);
echo $response->getBody();GET /v1/on-this-day in PHP (PECL HTTP v1)
<?php
$request = new HttpRequest();
$request->setUrl('https://wikipedia-search.p.apihiver.com/v1/on-this-day');
$request->setMethod(HTTP_METH_GET);
$request->setQueryData([
'month' => '{month}',
'day' => '{day}',
'type' => '{type}',
'lang' => '{lang}',
'limit' => '2'
]);
$request->setHeaders([
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY'
]);
try {
$response = $request->send();
echo $response->getBody();
} catch (HttpException $ex) {
echo $ex;
}GET /v1/on-this-day in PHP (PECL HTTP v2)
<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://wikipedia-search.p.apihiver.com/v1/on-this-day');
$request->setRequestMethod('GET');
$request->setQuery(new http\QueryString([
'month' => '{month}',
'day' => '{day}',
'type' => '{type}',
'lang' => '{lang}',
'limit' => '2'
]));
$request->setHeaders([
'Accept' => 'application/json',
'X-API-Key' => 'YOUR_API_KEY'
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();GET /v1/on-this-day in Java (AsyncHttp)
AsyncHttpClient client = new DefaultAsyncHttpClient();
client.prepare("GET", "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")
.setHeader("Accept", "application/json")
.setHeader("X-API-Key", "YOUR_API_KEY")
.execute()
.toCompletableFuture()
.thenAccept(System.out::println)
.join();
client.close();GET /v1/on-this-day in Java (java.net.http)
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2"))
.header("Accept", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());GET /v1/on-this-day in Java (OkHttp)
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")
.get()
.addHeader("Accept", "application/json")
.addHeader("X-API-Key", "YOUR_API_KEY")
.build();
Response response = client.newCall(request).execute();GET /v1/on-this-day in Java (Unirest)
HttpResponse<String> response = Unirest.get("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")
.header("Accept", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.asString();GET /v1/on-this-day in C# (HttpClient)
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Get,
RequestUri = new Uri("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2"),
Headers =
{
{ "Accept", "application/json" },
{ "X-API-Key", "YOUR_API_KEY" },
},
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}GET /v1/on-this-day in C# (RestSharp)
var client = new RestClient("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2");
var request = new RestRequest("", Method.Get);
request.AddHeader("Accept", "application/json");
request.AddHeader("X-API-Key", "YOUR_API_KEY");
var response = client.Execute(request);GET /v1/on-this-day in Go (NewRequest)
package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Accept", "application/json")
req.Header.Add("X-API-Key", "YOUR_API_KEY")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}GET /v1/on-this-day in Ruby (net::http)
require 'uri'
require 'net/http'
url = URI("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-API-Key"] = 'YOUR_API_KEY'
response = http.request(request)
puts response.read_bodyGET /v1/on-this-day in Swift (NSURLSession)
import Foundation
let headers = [
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY"
]
let request = NSMutableURLRequest(url: NSURL(string: "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error as Any)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()GET /v1/on-this-day in Objective-C (NSURLSession)
#import <Foundation/Foundation.h>
NSDictionary *headers = @{ @"Accept": @"application/json",
@"X-API-Key": @"YOUR_API_KEY" };
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2"]
cachePolicy:NSURLRequestUseProtocolCachePolicy
timeoutInterval:10.0];
[request setHTTPMethod:@"GET"];
[request setAllHTTPHeaderFields:headers];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
if (error) {
NSLog(@"%@", error);
} else {
NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
NSLog(@"%@", httpResponse);
}
}];
[dataTask resume];GET /v1/on-this-day in Kotlin (OkHttp)
val client = OkHttpClient()
val request = Request.Builder()
.url("https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2")
.get()
.addHeader("Accept", "application/json")
.addHeader("X-API-Key", "YOUR_API_KEY")
.build()
val response = client.newCall(request).execute()GET /v1/on-this-day in C (libcurl)
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "X-API-Key: YOUR_API_KEY");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);GET /v1/on-this-day in Clojure (clj-http)
(require '[clj-http.client :as client])
(client/get "https://wikipedia-search.p.apihiver.com/v1/on-this-day" {:headers {:X-API-Key "YOUR_API_KEY"}
:query-params {:month "{month}"
:day "{day}"
:type "{type}"
:lang "{lang}"
:limit "2"}
:accept :json})GET /v1/on-this-day in OCaml (CoHTTP)
open Cohttp_lwt_unix
open Cohttp
open Lwt
let uri = Uri.of_string "https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2" in
let headers = Header.add_list (Header.init ()) [
("Accept", "application/json");
("X-API-Key", "YOUR_API_KEY");
] in
Client.call ~headers `GET uri
>>= fun (res, body_stream) ->
(* Do stuff with the result *)GET /v1/on-this-day in R (httr)
library(httr)
url <- "https://wikipedia-search.p.apihiver.com/v1/on-this-day"
queryString <- list(
month = "{month}",
day = "{day}",
type = "{type}",
lang = "{lang}",
limit = "2"
)
response <- VERB("GET", url, query = queryString, add_headers('X-API-Key' = 'YOUR_API_KEY'), content_type(""), accept("application/json"))
content(response, "text")GET /v1/on-this-day in PowerShell (Invoke-WebRequest)
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("X-API-Key", "YOUR_API_KEY")
$response = Invoke-WebRequest -Uri 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2' -Method GET -Headers $headersGET /v1/on-this-day in PowerShell (Invoke-RestMethod)
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("X-API-Key", "YOUR_API_KEY")
$response = Invoke-RestMethod -Uri 'https://wikipedia-search.p.apihiver.com/v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2' -Method GET -Headers $headersGET /v1/on-this-day in HTTP (HTTP/1.1)
GET /v1/on-this-day?month=%7Bmonth%7D&day=%7Bday%7D&type=%7Btype%7D&lang=%7Blang%7D&limit=2 HTTP/1.1
Accept: application/json
X-Api-Key: YOUR_API_KEY
Host: wikipedia-search.p.apihiver.com
Example response (200, application/json)
Success.
1{
2 "date": "09-26",
3 "type": "events",
4 "count": 2,
5 "items": [
6 {
7 "text": "Hurricane Helene makes landfall in Perry, Florida as a Category 4 hurricane, killing over 250 people, causing US$78.7 billion in damage and becoming the deadliest hurricane in the mainland United States since Katrina.",
8 "year": 2024,
9 "pages": [
10 {
11 "url": "https://en.wikipedia.org/wiki/Hurricane_Helene",
12 "title": "Hurricane Helene"
13 },
14 {
15 "url": "https://en.wikipedia.org/wiki/Perry%2C_Florida",
16 "title": "Perry, Florida"
17 },
18 {
19 "url": "https://en.wikipedia.org/wiki/Saffir%E2%80%93Simpson_scale",
20 "title": "Saffir–Simpson scale"
21 }
22 ]
23 },
24 {
25 "text": "A mass shooting occurs at a school in Izhevsk, Udmurtia, Russia, resulting in the deaths of 18 people, including 11 children.",
26 "year": 2022,
27 "pages": [
28 {
29 "url": "https://en.wikipedia.org/wiki/Izhevsk_school_shooting",
30 "title": "Izhevsk school shooting"
31 },
32 {
33 "url": "https://en.wikipedia.org/wiki/Izhevsk",
34 "title": "Izhevsk"
35 },
36 {
37 "url": "https://en.wikipedia.org/wiki/Udmurtia",
38 "title": "Udmurtia"
39 }
40 ]
41 }
42 ],
43 "attribution": "Content from Wikipedia, CC BY-SA 4.0"
44}Errors
- 400 — A required parameter is missing or a value has the wrong format.
1{ 2 "error": { 3 "code": "INVALID_INPUT", 4 "message": "A parameter has the wrong format — the message names it." 5 } 6}
Gateway errors (missing key, no subscription, rate limits) are listed in Error codes.