API de suivi de positions : positions du top 10 Google en direct par pays et appareil

Pourquoi une API SERP plutôt qu’un SaaS de suivi de positions

Un service de suivi de positions vous vend son calendrier, ses limites de mots-clés et ses rapports. Une API SERP vous vend la matière première : le top 10 en direct, ou jusqu’au top 100, pour chaque mot-clé ; le calendrier, le stockage et les rapports restent entre vos mains.

Serper.live devient ainsi le backend d’un outil de suivi qui vous appartient : un tableau de bord d’agence, un module de votre produit SEO, une tâche nocturne qui écrit les positions dans votre base de données. Pas de licences par utilisateur, pas de quotas de mots-clés, pas de forfaits par projet ; la facture correspond au nombre de recherches multiplié par le prix du marché.

Le compromis est clair : vous écrivez le planificateur et le stockage, et chaque vérification est une vraie recherche Google qui prend quelques secondes. En échange, chaque position enregistrée a été obtenue à un moment connu, pour un pays et un appareil connus, jamais depuis un cache.

Comment obtenir la position d’un mot-clé

Une requête par mot-clé, pays et appareil. La documentation contient la référence complète ; dans votre code, la logique tient en quatre étapes, et l’exemple ci-dessous est la même requête en curl, JavaScript et Python :

1. Envoyez POST /v1/search avec query, country et device, et en option language et limit. Une recherche en direct répond généralement en 2–3 secondes, la première vers un marché après une pause prend plus de temps : gardez un délai d’attente client d’au moins 100 secondes et lancez les vérifications depuis une file d’attente.
2. Lisez organic[]. Chaque entrée contient position, title, url, domain et snippet, dans l’ordre où Google les affiche.
3. Trouvez l’entrée dont le domain correspond au site suivi et enregistrez sa position avec fetchedAt et requestId. Décidez à l’avance si un sous-domaine compte pour le domaine principal, et ignorez un www. initial.
4. Aucune correspondance signifie que le site est hors de la plage demandée pour cette vérification, le top 10 par défaut. Enregistrez-le aussi : un mot-clé qui sort du top 10, c’est exactement ce qu’un outil de suivi doit repérer.

curl -s -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"DE","device":"desktop"}' \
  | jq '.organic[] | select(.domain == "example.com") | .position'

const response = await fetch('https://api.serper.live/v1/search', {
    method: 'POST',
    headers: {
        Authorization: 'Bearer sl_live_YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query: 'best coffee shops', country: 'DE', device: 'desktop' }),
    signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const hit = organic.find(row => row.domain === 'example.com');

console.log(hit ? hit.position : 'outside the top 10');

import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
    json={"query": "best coffee shops", "country": "DE", "device": "desktop"},
    timeout=100,
)
organic = response.json()["organic"]
position = next((row["position"] for row in organic if row["domain"] == "example.com"), None)
print(position or "outside the top 10")

Marchés et appareils

Marchés ouverts actuellement : Allemagne, France, Royaume-Uni, Turquie, Ukraine et États-Unis. Chaque marché a un code à deux lettres que vous passez dans country, une langue d’interface Google par défaut que vous pouvez remplacer avec language, et l’ordinateur comme le mobile au même prix.

Les nouveaux marchés apparaissent dans GET /v1/countries et sur la page des tarifs dès leur lancement ; votre intégration ne change pas.

Combien ça coûte

Une vérification correspond à une requête : dès $0.01 par mot-clé, par pays et par appareil, soit $10.00 pour 1 000 vérifications. Il n’y a pas d’abonnement : le crédit est prépayé en USDT ou USDC à partir de 5 $ et n’expire jamais.

Exemple : 500 mots-clés vérifiés une fois par jour sur un appareil représentent environ 15 000 requêtes par mois. Multipliez par le prix de votre marché, ou saisissez ce nombre dans le calculateur de la page des tarifs. L’ordinateur et le mobile doublent ce nombre ; deux vérifications par jour le doublent encore.

Les limites à connaître

• Une recherche en direct prend généralement 2–3 secondes, la première vers un marché après une pause davantage. Prévoyez le débit : lancez les vérifications en parallèle depuis une file d’attente, avec un délai d’attente client d’au moins 100 secondes.
• Les positions vont aussi loin que vous le demandez : limit de 1 à 100, 10 par défaut. Chaque bloc de 10 entamé coûte un prix du marché : une vérification du top 30 réserve donc trois prix et ne conserve que les blocs qui ont reçu des résultats ; un site hors de la plage demandée est signalé comme absent, pas comme une position.
• Rien n’est mis en cache. Deux requêtes identiques sont deux recherches en direct et deux débits ; conservez les résultats de votre côté.
• Les résultats dépendent du pays, de l’appareil et de la langue que vous envoyez. Ne comparez une position qu’avec des vérifications antérieures faites avec ces trois mêmes valeurs.
• Google fait varier les résultats d’une vérification à l’autre et dans le temps. Une vérification en direct est un échantillon ; la tendance sur plusieurs jours est le signal à rapporter.

Commencez par un mot-clé

Essayez avant d’écrire du code : le Playground lance trois recherches en direct par adresse IP et par jour sans compte, et son champ de domaine affiche la position immédiatement. Ensuite, créez un compte, rechargez à partir de 5 $ et envoyez la première requête depuis le démarrage rapide.