seo/
google-organic-serp

Récupérez une page de résultats Google en direct pour une requête et un marché, avec URL de destination, titres, positions, types d’éléments et détails de résultat sous forme d’enregistrements normalisés.

Google Organic SERP API

Instantané SERP en direct
Choix de l’appareil
Éléments de résultat variés
0,1 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Google Organic SERP

Les pages de résultats organiques de Google associent des liens classés à d’autres éléments visibles, comme les extraits optimisés, les questions, les résultats locaux et les vidéos. Leurs destinations, positions, types d’éléments et détails de présentation servent à relever des classements, à analyser la mise en page et à comparer appareils ou marchés.

Fonctionnalités de la Google Organic SERP API

  • Instantané de marché pour une requêteInterroge Google avec une seule requête, un marché, une langue et un type d’appareil (ordinateur ou mobile) explicites, pour obtenir une page de résultats comparable à un instant donné.
  • Champs de position et de destinationRenvoie, lorsqu’ils sont disponibles, les URL de destination, les titres affichés, les positions dans le groupe, les positions absolues et les numéros de page de résultats, dans des champs normalisés.
  • Couverture de tous les éléments de la SERPConserve les liens organiques et les autres types de résultats renvoyés, extra.type indiquant le genre d’élément que chaque enregistrement représente.
  • Contexte complet de chaque élémentGarde dans extra l’objet complet propre à chaque élément, pour que domaines, extraits, fils d’Ariane, images et attributs de résultats enrichis restent accessibles quand ils existent.

Paramètres de la Google Organic SERP API

ParamètresObligatoireDescription
queryObligatoireRequête de recherche obligatoire et non vide. Une tâche accepte une seule requête.
location_codeFacultatifCode numérique positif du marché. Le Playground utilise 2840 par défaut, pour les États-Unis.
location_nameFacultatifNom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code.
language_codeFacultatifCode de langue de recherche de 2 à 10 caractères. Le Playground utilise en par défaut.
languageFacultatifNom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code.
deviceFacultatifContexte d’appareil de la recherche : desktop ou mobile.
results_limitFacultatifProfondeur de classement demandée, de 1 à 700. C’est un plafond, qui ne garantit pas le même nombre d’éléments aplatis.

Comment utiliser la Google Organic SERP API

Envoyez une requête avec des réglages de marché par codes et une profondeur bornée, puis lisez chaque élément de SERP normalisé dans la tâche asynchrone terminée.

  1. Choisissez une requête query non vide, un location_code, un language_code, un device et un results_limit de 1 à 200.
  2. Envoyez la charge utile en POST à /v1/seo/google-organic-serp et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items, puis demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/seo/google-organic-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Google Organic SERP API

  • Relevés de positions actuelles : Associez les URL de destination à rank.group, rank.absolute, rank.page et collected_at pour noter où apparaissent les pages renvoyées pour une requête donnée.
  • Comparaison entre appareils et marchés : Envoyez des requêtes jumelles en contrôlant device, location_code et language_code pour comparer destinations et positions d’un contexte à l’autre.
  • Analyse de la mise en page de la SERP : Examinez extra.type et les champs propres à chaque élément pour distinguer les liens classés des questions, extraits, résultats locaux, vidéos et autres fonctionnalités de page renvoyées.

Conseils d’expert pour la Google Organic SERP API

  • Gardez query, location_code et language_code identiques quand vous comparez ordinateur et mobile, pour que l’appareil soit la seule variable prévue.
  • Utilisez un results_limit d’au plus 200, même si la validation de la route accepte des valeurs plus grandes, car la profondeur des résultats avancés en direct est plafonnée à 200.
  • Aiguillez selon extra.type avant de lire les clés propres à un élément, et admettez que url et les valeurs de rank puissent manquer pour les éléments qui ne les exposent pas.
  • Voyez dans rank.page le numéro de la page de résultats ; utilisez next_cursor à part pour paginer les enregistrements de résultats stockés par SocQ.
  • Stockez extra comme un objet souple, car ses clés disponibles varient selon le type d’élément de SERP et peuvent évoluer.

En complément de la Google Organic SERP API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques SEO.

  • Keyword Difficulty API — Comparez la difficulté de classement organique d’un lot de mots-clés soumis et obtenez chaque mot-clé disponible avec son score normalisé.
  • Keyword Overview API — Enrichissez un lot de mots-clés soumis avec la demande, la concurrence payante, la difficulté, les recherches mensuelles et l’intention de recherche disponibles.
  • Keyword Search Volume API — Mesurez des mots-clés connus avec le volume de recherche, le CPC, la concurrence payante et l’historique mensuel des recherches disponibles.
  • Related Keywords API — Suivez les chemins de recherches associées à partir d’une requête de départ avec contrôle de la profondeur, mesures de mots-clés disponibles, intention de recherche et lignes sources complètes.
  • Search Intent API — Classez l’intention de recherche principale et secondaire d’un lot de mots-clés soumis, en conservant les probabilités sources et les enregistrements complets.
  • Google News API — Collectez les articles Google News d’une recherche, à la une d’abord, avec titre, média, lien direct vers l’article, extrait et heure de publication.

Explorer d’autres plateformes

Combinez les données SEO avec les données publiques d’autres plateformes sociales prises en charge.

Google Organic SERP API — FAQ

Google Organic SERP API est une interface programmatique qui récupère une page de résultats Google en direct à partir d’une requête, d’un code de marché, d’un code de langue et d’un appareil. Elle renvoie des destinations, titres, positions et types d’éléments normalisés, ainsi que les détails complets propres à chaque élément.

Le Playground accepte une requête query obligatoire, plus location_code, language_code, device et results_limit. Il s’appuie sur des sélecteurs de marché et de langue par codes, afin d’éviter les combinaisons ambiguës avec les alternatives par nom.

Non. Une page de résultats avancés en direct peut contenir des liens organiques, des extraits optimisés, des questions, des résultats locaux, des vidéos et d’autres éléments visibles ; inspectez extra.type pour chaque enregistrement.

Oui. Certains éléments de la page de résultats n’exposent ni URL de destination ni toutes les valeurs de position ; les clients doivent donc considérer url, rank.group, rank.absolute et rank.page comme pouvant être nuls.

Chaque élément de SERP normalisé renvoyé coûte 0,1 crédit SocQ. Un ensemble de résultats vide n’entraîne aucun frais de résultat, et la profondeur demandée est une estimation, non un nombre garanti d’éléments renvoyés.