Response shape

Every Google engine returns the same top-level structure. The specific fields inside organic_results and the SERP feature blocks vary by engine, but the envelope is identical.

Top-level fields

Field	Type	Description
search_metadata	object	Query echo, timing, request id
search_parameters	object	All the parameters you sent
search_information	object	Total results, query displayed
organic_results	array	Ranked web results
pagination	object	Next/previous page cursors
serpapi_pagination	object	Canonical pagination helpers

SERP features appear as additional top-level fields when present on the page:

Field	Engine that returns it
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..." }
  }
}

Pass start to the next page (10, 20, …) or follow the next URL directly.

Error responses

On failure, the top level contains only error and error_code:

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

See also

• Google SERP overview