Formato da resposta

Todo mecanismo do Google retorna a mesma estrutura de nível superior. Os campos específicos dentro de organic_results e os blocos de recursos de SERP variam conforme o mecanismo, mas o envelope é idêntico.

Campos de nível superior

Campo	Tipo	Descrição
search_metadata	object	Eco da consulta, tempo de execução, id da requisição
search_parameters	object	Todos os parâmetros que você enviou
search_information	object	Total de resultados, consulta exibida
organic_results	array	Resultados web classificados
pagination	object	Cursores de página seguinte/anterior
serpapi_pagination	object	Auxiliares canônicos de paginação

Os recursos de SERP aparecem como campos adicionais de nível superior quando presentes na página:

Campo	Mecanismo que o retorna
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..." }
  }
}

Passe start para a página seguinte (10, 20, …) ou siga a URL next diretamente.

Respostas de erro

Em caso de falha, o nível superior contém apenas error e error_code:

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

Veja também

• Visão geral do Google SERP