Si la demande d'API échoue, l'API renvoie un objet JSON contenant des informations sur l'erreur. Vous trouverez ci-dessous des exemples d'erreurs renvoyées lorsque la limite maximale de demandes d'API autorisée a été atteinte.
Code |
Paramètre |
---|---|
100 |
L'utilisateur n'a pas fourni de clé API. |
101 |
L'utilisateur a fourni une clé API non valide. |
102 |
L'utilisateur a épuisé le solde du compte. |
103 |
L'utilisateur a épuisé l'autorisation d'abonnement mensuel. |
104 |
Le compte utilisateur est inactif ou bloqué. |
105 |
L'utilisateur n'a pas spécifié de valeur obligatoire pour le paramètre [query]. |
106 |
L'utilisateur n'a pas spécifié de valeur requise pour le paramètre [système]. |
300 |
Erreur lors de la récupération des résultats de la recherche. |
301 |
Erreur lors de la récupération des résultats de la recherche avec le code HTTP. |
302 |
Une erreur s'est produite lors de la récupération des résultats de recherche avec un code d'erreur d'API Yandex. |
399 |
La demande d'API a échoué en raison d'une erreur inconnue. Veuillez contacter le support et signaler un bug. |
Paramètres de requête HTTP GET
Paramètre |
La description |
---|---|
api_key |
[Obligatoire] Votre clé d'accès API, disponible sur le tableau de bord de votre compte |
query |
[Obligatoire] Spécifiez n'importe quel terme de recherche (les opérateurs étendus tels que intext sont pris en charge :) |
system |
[Obligatoire] Spécifiez n'importe quel moteur de recherche google, yandex, bing (par défaut: google) |
domain |
[Facultatif] Spécifiez le domaine du moteur de recherche à utiliser: com, de, fr, etc. (par défaut: com). Téléchargez une liste de tous les domaines pris en charge: domains.csv |
result_cnt |
[Facultatif] Spécifiez le nombre de résultats (par défaut: 10 - affiche 10 résultats réguliers, MAX - 100 (10, 50, 100)) |
hl |
[Facultatif] Spécifiez la langue à utiliser pour votre demande (par défaut: en pour l'anglais). Téléchargez une liste de toutes les langues prises en charge: languages.csv |
gl |
[Facultatif] Saisissez le code du pays à utiliser pour votre demande (par défaut: en pour l'anglais). Téléchargez une liste des codes de pays à deux lettres pris en charge: countries.csv |
location |
[Facultatif] Indiquez un emplacement géographique pour votre demande, qui sera traitée à l'aide du texte gratuit de Google (qui est automatiquement converti en chaîne UULE). Téléchargez la liste des emplacements pris en charge: locations.csv |
device |
[Facultatif] Spécifiez le périphérique à utiliser: ordinateur de bureau (par défaut) ou mobile |
Paramètres de requête HTTP GET
Paramètre |
La description |
---|---|
api_key |
[Obligatoire] Votre clé d'accès API, disponible sur le tableau de bord de votre compte |
query |
[Obligatoire] Spécifiez n'importe quel terme de recherche (les opérateurs étendus tels que intext sont pris en charge :) |
system |
[Obligatoire] Spécifiez n'importe quel moteur de recherche google, yandex, bing (par défaut: google) |
result_cnt |
[Facultatif] Spécifiez le nombre de résultats (par défaut: 10 - affiche 10 résultats réguliers, MAX - 100 (10, 50, 100)) |
lang |
[Facultatif] Spécifiez la langue à utiliser pour votre demande (par défaut: en pour l'anglais). Téléchargez une liste de toutes les langues prises en charge: languages.csv |
country |
[Facultatif] Saisissez le code du pays à utiliser pour votre demande (par défaut: en pour l'anglais). Téléchargez une liste des codes de pays à deux lettres pris en charge: markets.csv |
device |
[Facultatif] Spécifiez le périphérique à utiliser: ordinateur de bureau (par défaut) ou mobile |
Paramètres de requête HTTP GET
Paramètre |
La description |
---|---|
api_key |
[Obligatoire] Votre clé d'accès API, disponible sur le tableau de bord de votre compte |
query |
[Obligatoire] Spécifiez n'importe quel terme de recherche (les opérateurs étendus tels que site sont pris en charge :) |
system |
[Obligatoire] Spécifiez n'importe quel moteur de recherche google, yandex, bing (par défaut: google) |
domain |
[Facultatif] Spécifiez le domaine du moteur de recherche à utiliser: ru (par défaut). Autres domaines Yandex: uk, be, kk, com, com.tr |
result_cnt |
[Facultatif] Spécifiez le nombre de résultats (par défaut: 10 - affiche 10 résultats réguliers, MAX - 100) |
lr |
[Facultatif] Fournissez un emplacement géographique pour votre demande, qui sera traitée à l'aide d'un ID de région locale au format Yandex (par défaut: 213 (Moscou)). Téléchargez la liste des emplacements pris en charge: lr.csv |
Paramètre |
La description |
---|---|
position |
Renvoie la position du résultat de la recherche organique actuelle dans la liste complète des résultats |
link |
Renvoie l'URL réelle du résultat de la recherche organique |
title |
Renvoie le titre du résultat de la recherche organique |
snippet |
Renvoie une description du résultat de la recherche organique |