Structure de la réponse

Chaque moteur Google renvoie la même structure de haut niveau. Les champs spécifiques à l’intérieur de organic_results et les blocs de fonctionnalités SERP varient selon le moteur, mais l’enveloppe est identique.

Champs de premier niveau

Champ	Type	Description
search_metadata	object	Écho de la requête, timing, identifiant de requête
search_parameters	object	Tous les paramètres que vous avez envoyés
search_information	object	Total des résultats, requête affichée
organic_results	array	Résultats web classés
pagination	object	Curseurs de page suivante/précédente
serpapi_pagination	object	Assistants de pagination canoniques

Les fonctionnalités SERP apparaissent comme des champs supplémentaires de premier niveau lorsqu’elles sont présentes sur la page :

Champ	Moteur qui le renvoie
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..." }
  }
}

Transmettez start à la page suivante (10, 20, …) ou suivez directement l’URL next.

Réponses d’erreur

En cas d’échec, le niveau supérieur contient uniquement error et error_code :

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

Voir aussi

• Aperçu de Google SERP