Google Events Search
Google Events Search is used to fetch Google Events results by keyword.
- Search Google Events results by keyword
- Support region-based requests
- Support fetching results across a page range
- Return event title, URL, time, image, and location description
Use XCrawl to Fetch Google Events Search Results
Usage
curl -s -X POST 'https://run.xcrawl.com/v1/data' \
-H 'Authorization: Bearer $XCRAWL_API_KEY'\
-H 'Content-Type: application/json' \
-d '{
"engine": "google_events",
"location": "US",
"keyword_list": ["concert"],
"start_page": 1,
"end_page": 1
}'Request parameter notes:
enginemust begoogle_eventslocationspecifies the target regionkeyword_listaccepts one or more search keywordsstart_pageandend_pagecontrol the page range to fetch
Response Example
{
"result": [
{
"content": {
"title": "An Evening With David Sedaris",
"link": "https://www.google.com/search?hl=en&q=an+evening+with+david+sedaris...",
"img_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQVmsREGRFxWn8TpraZip7bfdi36mqD0ud_r1tkeks&s",
"time": "17 Jul",
"describe": "The JPT Film & Event Center, 49 Touro St"
}
}
]
}Parameters
Required Parameters
| Parameter | Type | Description |
|---|---|---|
location | string | Specifies the target region. |
keyword_list | array | Accepts one or more search keywords. |
start_page | number | Specifies the page number to start from. |
end_page | number | Specifies the page number to stop at. |
Parameter Notes
locationdefaults toUSlocationsupports multiple region values such asUS,HK,CA,GB, andJPkeyword_listdefaults to an empty array and should contain search keywordsstart_pagedefaults to1end_pagedefaults to1
Response Fields
Response data is returned under result[].content.
| Field | Type | Description |
|---|---|---|
title | string | Event title. |
link | string | Event result URL. |
img_url | string | Event image URL. |
time | string | Event time. |
describe | string | Event venue or short description. |
