crawlbaseDocs
Se connecter

Google SERP

Analysez une page de résultats de recherche Google en résultats organiques structurés, annonces, recherches associées, panneaux de connaissances et boîtes « Autres questions posées ».

Utilisation de l'API

Ajoutez &scraper=google-serp à une requête Crawling API. Encodez l'URL cible dans le paramètre url.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://www.google.com/search?q=samsung+social+accounts' \
  --data-urlencode 'scraper=google-serp' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.google.com/search?q=samsung+social+accounts',
    {'scraper': 'google-serp'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://www.google.com/search?q=samsung+social+accounts',
  { scraper: 'google-serp' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.google.com/search?q=samsung+social+accounts', scraper: 'google-serp')
data = JSON.parse(res.body)

Exemple d'URL d'entrée

L'URL passée dans le paramètre url (décodée pour plus de lisibilité) :

https://www.google.com/search?q=samsung+social+accounts

Structure de la réponse

Corps de la réponse JSON. Les types de champs peuvent être null lorsque la page source omet la valeur.

query
string
Requête de recherche.
results
array
Résultats de recherche organiques.
results[].title
string
Titre du résultat.
results[].url
string
URL de destination du résultat.
results[].snippet
string
Texte descriptif affiché sous le titre.
results[].sitelinks
array
Liens annexes optionnels sous le résultat principal.
ads
array
Annonces sponsorisées avec la même structure que results[].
related_searches
array<string>
Suggestions « Recherches associées à ».
people_also_ask
array
Section PAA avec des paires question/réponse.
knowledge_panel
object | null
Bloc panneau de connaissances lorsqu'il est présent.

Exemple de réponse

{
  "query": "samsung social accounts",
  "results": [
    {
      "title": "Samsung Mobile (@SamsungMobile) / X",
      "url": "https://x.com/SamsungMobile",
      "snippet": "The official Samsung Mobile X account…"
    }
  ],
  "related_searches": ["samsung instagram", "samsung official tiktok"],
  "people_also_ask": [
    {
      "question": "Does Samsung have a TikTok?",
      "answer": "Yes, Samsung is on TikTok at @samsung."
    }
  ]
}