Les nouveaux marchés
Chaque marché a un code à deux lettres pour le paramètre country et une langue par défaut de l’interface Google, que l’API envoie comme hl lorsque la requête ne contient pas language.
| Région | Marché | Code | Langue par défaut |
|---|---|---|---|
| Europe | Autriche | AT |
de |
| Europe | Belgique | BE |
nl |
| Europe | Danemark | DK |
da |
| Europe | Finlande | FI |
fi |
| Europe | Irlande | IE |
en |
| Europe | Italie | IT |
it |
| Europe | Pays-Bas | NL |
nl |
| Europe | Norvège | NO |
nb |
| Europe | Pologne | PL |
pl |
| Europe | Portugal | PT |
pt |
| Europe | Espagne | ES |
es |
| Europe | Suède | SE |
sv |
| Europe | Suisse | CH |
de |
| Amériques | Brésil | BR |
pt |
| Amériques | Canada | CA |
en |
| Amériques | Mexique | MX |
es |
| Asie-Pacifique | Australie | AU |
en |
| Asie-Pacifique | Inde | IN |
en |
Ils rejoignent l’Allemagne, la France, le Royaume-Uni, la Turquie, l’Ukraine et les États-Unis. La Belgique, la Suisse et le Canada, encore fermés au lancement de la version française du site, sont désormais ouverts. GET /v1/countries renvoie tous les marchés ouverts en JSON sans jeton, et la page des tarifs indique le prix de chacun.
Une seule requête pour tous les marchés
Rien ne change dans votre code. Envoyez POST /v1/search avec le nouveau code country, comme pour les marchés que vous suivez déjà. L’ordinateur et le mobile sont ouverts sur chaque marché au même prix, et limit renvoie jusqu’à 100 résultats en un seul appel.
L’exemple vérifie un mot-clé sur quatre nouveaux marchés, chacun dans sa langue et sur mobile, et affiche les positions d’un domaine. En Suisse, il remplace l’interface allemande par défaut par language fr :
curl -s -X POST https://api.serper.live/v1/search \
-H "Authorization: Bearer sl_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"logiciel de gestion de projet","country":"CH","language":"fr","device":"mobile"}' \
| jq '[.organic[] | select(.domain == "example.com") | .position]'
const checks = [
{ query: 'software de gestión de proyectos', country: 'ES' },
{ query: 'software de gestión de proyectos', country: 'MX' },
{ query: 'software de gestão de projetos', country: 'BR' },
{ query: 'logiciel de gestion de projet', country: 'CH', language: 'fr' },
];
for (const check of checks) {
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({ ...check, device: 'mobile' }),
signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const positions = organic.filter(row => row.domain === 'example.com').map(row => row.position);
console.log(check.country, check.query, positions);
}
import requests
CHECKS = [
{"query": "software de gestión de proyectos", "country": "ES"},
{"query": "software de gestión de proyectos", "country": "MX"},
{"query": "software de gestão de projetos", "country": "BR"},
{"query": "logiciel de gestion de projet", "country": "CH", "language": "fr"},
]
for check in CHECKS:
response = requests.post(
"https://api.serper.live/v1/search",
headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
json={**check, "device": "mobile"},
timeout=100,
)
organic = response.json()["organic"]
positions = [row["position"] for row in organic if row["domain"] == "example.com"]
print(check["country"], check["query"], positions)
<?php
$checks = [
['query' => 'software de gestión de proyectos', 'country' => 'ES'],
['query' => 'software de gestión de proyectos', 'country' => 'MX'],
['query' => 'software de gestão de projetos', 'country' => 'BR'],
['query' => 'logiciel de gestion de projet', 'country' => 'CH', 'language' => 'fr'],
];
foreach ($checks as $check) {
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
'content' => json_encode([...$check, 'device' => 'mobile']),
'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
$positions = array_column(array_filter($result['organic'], fn(array $row) => $row['domain'] === 'example.com'), 'position');
echo $check['country'], ' ', $check['query'], ' ', json_encode($positions), PHP_EOL;
}
Chaque vérification du top 10 coûte $0.005, le même prix sur tous les marchés. Le guide du suivi de positions traite de la planification, du stockage et de la correspondance des domaines.
Des marchés où l’on cherche en plusieurs langues
Sur plusieurs nouveaux marchés, on cherche en plus d’une langue : en néerlandais et en français en Belgique, en allemand, en français et en italien en Suisse, en anglais et en français au Canada, en finnois et en suédois en Finlande, en anglais et en hindi en Inde.
Le paramètre language fixe la langue de l’interface Google, par exemple fr pour la Belgique, la Suisse ou le Canada, it pour la Suisse italienne ou hi pour l’Inde. Il change les résultats : lors de nos mesures en Ukraine, changer la langue de l’interface n’a laissé que la moitié du top 10 pour la même requête.
Si votre public cherche en deux langues sur un marché, suivez-les comme des mots-clés distincts et enregistrez language avec chaque position, pour que les vérifications suivantes comparent ce qui est comparable.
Combien ça coûte
Une page de 10 résultats au plus coûte $0.005 sur tous les marchés, soit $5.00 pour 1 000 recherches ; la page des tarifs liste tous les marchés. Une vérification du top 30 coûte trois pages. Il n’y a pas d’abonnement : vous rechargez par carte dès 10 $ ou en USDT ou USDC dès 5 $, et le crédit n’expire jamais.
À partir de 100 000 recherches par mois sur un marché, nous convenons de conditions individuelles sur demande via la page de contact.
Dans les agents IA et MCP
Le serveur MCP de Serper.live lit les marchés depuis l’API : list_countries renvoie donc déjà les nouveaux, sans mise à jour. Demandez par exemple à votre agent : « Où se classe example.ch sur Google en Suisse, en français et sur mobile, pour logiciel de gestion de projet ? Vérifie le top 30. »
La configuration pour Claude Code, Claude Desktop, Cursor, VS Code et Codex se trouve dans la documentation.
Essayer un nouveau marché
Le Playground propose des exemples de recherches dans la langue locale pour chaque nouveau marché et lance trois recherches en direct par adresse IP et par jour, sans compte. Ensuite, créez un compte et envoyez la première requête depuis le démarrage rapide.
Il vous manque un pays ? Dites-nous lequel.