响应结构

每个 Google 引擎返回的顶层结构都相同。organic_results 内部的具体字段以及 SERP 功能模块会因引擎而异，但外层结构是一致的。

顶层字段

字段	类型	说明
search_metadata	object	查询回显、耗时、请求 id
search_parameters	object	你发送的所有参数
search_information	object	结果总数、显示的查询
organic_results	array	排序后的网页结果
pagination	object	上一页/下一页游标
serpapi_pagination	object	标准分页辅助字段

当页面中存在相应内容时，SERP 功能会以额外的顶层字段出现：

字段	返回该字段的引擎
ads	google
answer_box	google
knowledge_graph	google
related_questions	google
related_searches	google, bing, yandex
inline_images	google
inline_videos	google
local_results	google
local_map	google
shopping_results	google_shopping
news_results	google_news
jobs_results	google_jobs
events_results	google_events
places_results	google_maps
reviews_results	google_maps_reviews
interest_over_time	google_trends

search_metadata

{
  "id": "66f4a7b2e4b00b0001a1b2c3",
  "status": "Success",
  "created_at": "2026-02-01T12:34:56.789Z",
  "processed_at": "2026-02-01T12:34:58.012Z",
  "google_url": "https://www.google.com/search?q=pizza&...",
  "raw_html_file": "https://serp.shifter.io/raw_html/...",
  "total_time_taken": 2.31
}

organic_results

{
  "organic_results": [
    {
      "position": 1,
      "title": "Best Pizza in Chicago",
      "link": "https://example.com/pizza",
      "displayed_link": "example.com",
      "snippet": "Chicago's deep dish institution since 1955...",
      "favicon": "https://example.com/favicon.ico",
      "sitelinks": { "...": "..." }
    }
  ]
}

pagination

{
  "pagination": {
    "current": 1,
    "next": "https://serp.shifter.io/v1?engine=google&q=pizza&start=10&...",
    "other_pages": { "2": "...start=10...", "3": "...start=20..." }
  }
}

将 start 传递给下一页（10、20、……）或直接跟随 next URL。

错误响应

失败时，顶层只包含 error 和 error_code：

{
  "error": "Your API key is invalid",
  "error_code": 401
}

另请参阅

• Google SERP 概览