简体中文

English

简体中文

English

Google Events Search

Google Events Search 用于按关键词获取 Google Events 结果数据。

  • 按关键词抓取 Google Events 结果
  • 支持按地区发起请求
  • 支持按起止页范围抓取结果
  • 返回事件标题、链接、时间、图片和地点描述

使用 XCrawl 获取 Google Events 搜索结果

使用方式

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
  }'

请求参数说明：

  • engine 固定为 google_events
  • location 用于指定请求地区
  • keyword_list 用于传入一个或多个搜索关键词
  • start_page 和 end_page 用于控制抓取页码范围

响应示例

{
  "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"
      }
    }
  ]
}

参数说明

必填参数

参数类型说明
locationstring指定请求地区。
keyword_listarray传入一个或多个搜索关键词。
start_pagenumber指定从第几页开始抓取。
end_pagenumber指定抓取到第几页结束。

参数补充说明

  • location 默认值为 US
  • location 支持多个地区值，例如 US、HK、CA、GB、JP
  • keyword_list 默认值为空数组，数组元素为搜索关键词
  • start_page 默认值为 1
  • end_page 默认值为 1

响应字段

响应数据位于 result[].content。

字段类型说明
titlestring事件标题。
linkstring事件结果链接。
img_urlstring事件图片链接。
timestring事件时间。
describestring事件地点或简要说明。