Google Events
Google Events: Search
Search from Google Events. Costs 1 credit per successful call.
GET
https://api.perceptlayer.com
/
v1
/
google-events
/
search
Search
curl --request GET \
--url https://api.perceptlayer.com/v1/google-events/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.perceptlayer.com/v1/google-events/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.perceptlayer.com/v1/google-events/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.perceptlayer.com/v1/google-events/search';
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.perceptlayer.com/v1/google-events/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.perceptlayer.com/v1/google-events/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.perceptlayer.com/v1/google-events/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.perceptlayer.com/v1/google-events/search")
.header("X-API-Key", "<api-key>")
.asString();{
"endpoint": "google-events.search",
"params": {
"q": "events in london this weekend",
"hl": "en",
"gl": "uk"
},
"response": {
"search_parameters": {
"engine": "google_events",
"q": "events in london this weekend",
"gl": "uk",
"hl": "en",
"start": 0
},
"search_information": {
"events_results_state": "Results for exact spelling"
},
"events_results": [
{
"position": 1,
"title": "Halloween River Cruise",
"date": {
"when": "Sat, 24 Oct 2026, 19:00",
"start_time": "2026-10-24T18:00:00Z",
"end_time": "2026-10-24T19:00:00Z"
},
"address": [
"Riverside Building, London Eye, County Hall, Westminster Bridge Rd, London SE1 7PB"
],
"link": "https://www.google.com/search?q=Halloween%20River%20Cruise&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11p1p2jqd4",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=RQBgTLyMC69TCDgHBfTZwrGhJsdlPpvoll7nMm62Z10lrDi0-QM_3j3KuA58NFxapJaeTffpOKHaC_VoQhqIRvJrUZqO51aPpOAz2ir09x0rkcu68YRzH-SHTfU0NgRiaZTii8YZptd2RtRMjRAn_ZNDjGUd9lPOxJkhFg",
"link": "https://www.google.com/maps/search/?api=1&query=Riverside%20Building%2C%20London%20Eye%2C%20County%20Hall%2C%20Westminster%20Bridge%20Rd%2C%20London%20SE1%207PB"
},
"description": "A 60-minute London Eye River Cruise along the Thames with live actors telling ghost stories of Jack the Ripper, the ghost of Captain Kidd and the haunted cries of Old London Bridge. Suitable for children aged 5 and over, with a complimentar…",
"ticket_info": [
{
"source": "Mato Events",
"link": "https://ma.to/event/london-eye-halloween-river-cruise-2026-10-24",
"link_type": "tickets"
},
{
"source": "londoneye.com",
"link": "https://www.londoneye.com/",
"link_type": "more info"
}
],
"venue": {
"name": "London Eye",
"rating": 4.5,
"reviews": 206031,
"link": "https://www.google.com/search?q=London+Eye&ludocid=4796882358840715922"
},
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIyGJkdedlIlKt-RDN0ud-FP177CCvK_cM-VDPtGilIsEngLzXTMXfTGmHpgIvc6S0f3hXZaJaUcgcI3w"
},
{
"position": 2,
"title": "Wicked Westminster: The Original London Ghost Walk",
"date": {
"when": "Sun, 25 Oct 2026",
"start_time": "2026-10-24T23:00:00Z",
"end_time": "2026-10-24T23:00:00Z"
},
"address": [
"Constance Fund fountain of Diana",
"London SW1A 1RN"
],
"link": "https://www.google.com/search?q=Wicked%20Westminster%3A%20The%20Original%20London%20Ghost%20Walk&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11nb85f4cp",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=cuuFeFV7z5z-z57ca3dyNw_vfAvTaS5xUyGz0lK44C9U4tMFKWjDPtgK1WKD9YhBdTXASj04RqNCXnrmorv4-25xUDno2Un0RemVfM504V0BNrseizwSnfvTE64tIRm7UT4QVARYGR-f1x3hpkWUdgQZQH4faH7MS0UpWBXse-JL",
"link": "https://www.google.com/maps/search/?api=1&query=Constance%20Fund%20fountain%20of%20Diana%2C%20London%20SW1A%201RN"
},
"description": "Highlights ? Explore London?s haunted streets on an atmospheric evening ghost walk ?? Discover the site of London?s most haunted house ? End your chilling journey at the iconic and mysterious Tower of London General Info ?",
"ticket_info": [
{
"source": "CompareTheTicketPrice.com",
"link": "https://www.comparetheticketprice.com/performance/wicked-westminster:-the-original-london-ghost-walk/4732284",
"link_type": "tickets"
},
{
"source": "en.m.wikipedia.org",
"link": "https://en.m.wikipedia.org/wiki/Diana_Fountain,_Green_Park",
"link_type": "more info"
}
],
"venue": {
"name": "Constance Fund fountain of Diana",
"rating": 4.5,
"reviews": 151,
"link": "https://www.google.com/search?q=Constance+Fund+fountain+of+Diana&ludocid=8627082062591940256"
},
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSAYNyt45WcUl0s7UfneGpBU9sKWVTGXjS8Wz3gi6OvjIyTiGU6xxY2q0967Mi87oNRo19IVCJau9VrZvw"
},
{
"position": 3,
"title": "The Standard of Living",
"date": {
"when": "Sat, 24 Oct 2026, 14:30",
"start_time": "2026-10-24T13:30:00Z",
"end_time": "2026-10-24T14:30:00Z"
},
"address": [
"Theatre Royal Haymarket",
"Haymarket, London SW1Y 4HT"
],
"link": "https://www.google.com/search?q=The%20Standard%20of%20Living&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11zyzh36jm",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=7SRepPKFRTZQB0kGrSd0B4_HlPumKi-bPM4ZbglHWX7-Xmr6YGLmFEM7QDSyRYbBElTTtfnhHNVydCWeboSpjM3cugXkhwymOxk9TrxV2ZLBkedSn3oinS9kGtzze2gg0yFqFaBdb8LZromH21akht56vZzWMmrAouLKwGyGi2aK",
"link": "https://www.google.com/maps/search/?api=1&query=Theatre%20Royal%20Haymarket%2C%20Haymarket%2C%20London%20SW1Y%204HT"
},
"description": "<h2><strong>Why watch The Standard of Living</strong></h2><ul><li><p>A razor-sharp new play by Olivier Award-winner James Graham, The Standard of Living explores the intersection of politics, art, and human desire with brilliance and biting…",
"ticket_info": [
{
"source": "Headout",
"link": "https://www.headout.com/london-theatre-tickets/the-standard-of-living-e-46889/?ci=14&cm=search_46889_en&source=ecat",
"link_type": "tickets"
}
],
"venue": {
"name": "Theatre Royal Haymarket",
"rating": 4.599999904632568,
"reviews": 6291,
"link": "https://www.google.com/search?q=Theatre+Royal+Haymarket&ludocid=17647890677118172177"
},
"price": "£156",
"extracted_price": 156,
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ0zfbDjd0z_iYGlO9NV2Nqr0mBUFZh6lAtOSafvCaFQFC5scmPqE_uo2Efr-j3GL4czmgZIpjyUqoxaYA"
}
],
"pagination": {
"current_page": 1,
"start": 0
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}1 credit per successful call; failed calls are free. See the Google Events API overview for every Google Events endpoint.
Authorizations
Query Parameters
Maximum string length:
255Maximum string length:
2Maximum string length:
255Maximum string length:
500Maximum string length:
200Was this page helpful?
⌘I
Search
curl --request GET \
--url https://api.perceptlayer.com/v1/google-events/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.perceptlayer.com/v1/google-events/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.perceptlayer.com/v1/google-events/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.perceptlayer.com/v1/google-events/search';
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.perceptlayer.com/v1/google-events/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.perceptlayer.com/v1/google-events/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.perceptlayer.com/v1/google-events/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.perceptlayer.com/v1/google-events/search")
.header("X-API-Key", "<api-key>")
.asString();{
"endpoint": "google-events.search",
"params": {
"q": "events in london this weekend",
"hl": "en",
"gl": "uk"
},
"response": {
"search_parameters": {
"engine": "google_events",
"q": "events in london this weekend",
"gl": "uk",
"hl": "en",
"start": 0
},
"search_information": {
"events_results_state": "Results for exact spelling"
},
"events_results": [
{
"position": 1,
"title": "Halloween River Cruise",
"date": {
"when": "Sat, 24 Oct 2026, 19:00",
"start_time": "2026-10-24T18:00:00Z",
"end_time": "2026-10-24T19:00:00Z"
},
"address": [
"Riverside Building, London Eye, County Hall, Westminster Bridge Rd, London SE1 7PB"
],
"link": "https://www.google.com/search?q=Halloween%20River%20Cruise&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11p1p2jqd4",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=RQBgTLyMC69TCDgHBfTZwrGhJsdlPpvoll7nMm62Z10lrDi0-QM_3j3KuA58NFxapJaeTffpOKHaC_VoQhqIRvJrUZqO51aPpOAz2ir09x0rkcu68YRzH-SHTfU0NgRiaZTii8YZptd2RtRMjRAn_ZNDjGUd9lPOxJkhFg",
"link": "https://www.google.com/maps/search/?api=1&query=Riverside%20Building%2C%20London%20Eye%2C%20County%20Hall%2C%20Westminster%20Bridge%20Rd%2C%20London%20SE1%207PB"
},
"description": "A 60-minute London Eye River Cruise along the Thames with live actors telling ghost stories of Jack the Ripper, the ghost of Captain Kidd and the haunted cries of Old London Bridge. Suitable for children aged 5 and over, with a complimentar…",
"ticket_info": [
{
"source": "Mato Events",
"link": "https://ma.to/event/london-eye-halloween-river-cruise-2026-10-24",
"link_type": "tickets"
},
{
"source": "londoneye.com",
"link": "https://www.londoneye.com/",
"link_type": "more info"
}
],
"venue": {
"name": "London Eye",
"rating": 4.5,
"reviews": 206031,
"link": "https://www.google.com/search?q=London+Eye&ludocid=4796882358840715922"
},
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIyGJkdedlIlKt-RDN0ud-FP177CCvK_cM-VDPtGilIsEngLzXTMXfTGmHpgIvc6S0f3hXZaJaUcgcI3w"
},
{
"position": 2,
"title": "Wicked Westminster: The Original London Ghost Walk",
"date": {
"when": "Sun, 25 Oct 2026",
"start_time": "2026-10-24T23:00:00Z",
"end_time": "2026-10-24T23:00:00Z"
},
"address": [
"Constance Fund fountain of Diana",
"London SW1A 1RN"
],
"link": "https://www.google.com/search?q=Wicked%20Westminster%3A%20The%20Original%20London%20Ghost%20Walk&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11nb85f4cp",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=cuuFeFV7z5z-z57ca3dyNw_vfAvTaS5xUyGz0lK44C9U4tMFKWjDPtgK1WKD9YhBdTXASj04RqNCXnrmorv4-25xUDno2Un0RemVfM504V0BNrseizwSnfvTE64tIRm7UT4QVARYGR-f1x3hpkWUdgQZQH4faH7MS0UpWBXse-JL",
"link": "https://www.google.com/maps/search/?api=1&query=Constance%20Fund%20fountain%20of%20Diana%2C%20London%20SW1A%201RN"
},
"description": "Highlights ? Explore London?s haunted streets on an atmospheric evening ghost walk ?? Discover the site of London?s most haunted house ? End your chilling journey at the iconic and mysterious Tower of London General Info ?",
"ticket_info": [
{
"source": "CompareTheTicketPrice.com",
"link": "https://www.comparetheticketprice.com/performance/wicked-westminster:-the-original-london-ghost-walk/4732284",
"link_type": "tickets"
},
{
"source": "en.m.wikipedia.org",
"link": "https://en.m.wikipedia.org/wiki/Diana_Fountain,_Green_Park",
"link_type": "more info"
}
],
"venue": {
"name": "Constance Fund fountain of Diana",
"rating": 4.5,
"reviews": 151,
"link": "https://www.google.com/search?q=Constance+Fund+fountain+of+Diana&ludocid=8627082062591940256"
},
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSAYNyt45WcUl0s7UfneGpBU9sKWVTGXjS8Wz3gi6OvjIyTiGU6xxY2q0967Mi87oNRo19IVCJau9VrZvw"
},
{
"position": 3,
"title": "The Standard of Living",
"date": {
"when": "Sat, 24 Oct 2026, 14:30",
"start_time": "2026-10-24T13:30:00Z",
"end_time": "2026-10-24T14:30:00Z"
},
"address": [
"Theatre Royal Haymarket",
"Haymarket, London SW1Y 4HT"
],
"link": "https://www.google.com/search?q=The%20Standard%20of%20Living&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11zyzh36jm",
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=7SRepPKFRTZQB0kGrSd0B4_HlPumKi-bPM4ZbglHWX7-Xmr6YGLmFEM7QDSyRYbBElTTtfnhHNVydCWeboSpjM3cugXkhwymOxk9TrxV2ZLBkedSn3oinS9kGtzze2gg0yFqFaBdb8LZromH21akht56vZzWMmrAouLKwGyGi2aK",
"link": "https://www.google.com/maps/search/?api=1&query=Theatre%20Royal%20Haymarket%2C%20Haymarket%2C%20London%20SW1Y%204HT"
},
"description": "<h2><strong>Why watch The Standard of Living</strong></h2><ul><li><p>A razor-sharp new play by Olivier Award-winner James Graham, The Standard of Living explores the intersection of politics, art, and human desire with brilliance and biting…",
"ticket_info": [
{
"source": "Headout",
"link": "https://www.headout.com/london-theatre-tickets/the-standard-of-living-e-46889/?ci=14&cm=search_46889_en&source=ecat",
"link_type": "tickets"
}
],
"venue": {
"name": "Theatre Royal Haymarket",
"rating": 4.599999904632568,
"reviews": 6291,
"link": "https://www.google.com/search?q=Theatre+Royal+Haymarket&ludocid=17647890677118172177"
},
"price": "£156",
"extracted_price": 156,
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ0zfbDjd0z_iYGlO9NV2Nqr0mBUFZh6lAtOSafvCaFQFC5scmPqE_uo2Efr-j3GL4czmgZIpjyUqoxaYA"
}
],
"pagination": {
"current_page": 1,
"start": 0
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}