Réponse rapide
Comment vérifier si l'API SerpCrypto fonctionne ?
Appelez GET https://serpcrypto.com/api/v1/credits avec votre clé : c'est gratuit et la réponse en JSON indique vos crédits restants. Un 200 signifie que l'API et votre clé fonctionnent. Les erreurs 502 et 504 proviennent d'une recherche qui a échoué et ne sont jamais facturées. SerpCrypto publie les incidents dans le changelog ; aucun chiffre de disponibilité n'est publié avant d'avoir été mesuré.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"Que signifie chaque réponse ?
| Statut HTTP | Signification | Facturé ? | Que faire |
|---|---|---|---|
| 200 | L'API fonctionne ; pour une recherche, les résultats sont dans le corps de la réponse | 1 crédit pour une recherche réussie ; la vérification des crédits est gratuite | Rien |
401 invalid_api_key | La clé est absente, erronée ou révoquée | Non | Recopiez la clé depuis le dashboard |
402 insufficient_credits | Votre compte n'a plus de crédits | Non | Achetez un pack sur la page de tarifs |
429 concurrency_limit | Trop de recherches en même temps | Non | Réduisez les requêtes parallèles, ou demandez une limite plus élevée |
502 search_failed | La recherche n'a pas pu aboutir | Non | Réessayez après un court délai |
504 search_timeout | Aucune réponse dans les délais | Non | Réessayez après un court délai |
Le problème vient-il de mon côté, du vôtre ou du moteur ?
Lancez d'abord la vérification gratuite, puis une recherche simple, puis votre vraie requête. Chaque étape isole une couche.
- L'appel des crédits échoue avec 401 : le problème vient de la clé. Vérifiez le format du header :
Authorization: Bearer <key>, avec un seul espace. - L'appel des crédits fonctionne mais chaque recherche renvoie 502 : la couche de collecte ou le moteur est en panne pour tout le monde. Attendez quelques minutes et réessayez ; rien n'est facturé entre-temps.
- Une requête simple fonctionne mais la vôtre échoue avec 400 : un paramètre est hors de la liste autorisée. La référence de recherche liste chaque valeur.
- Les résultats diffèrent de votre navigateur : c'est généralement la localisation, la langue ou l'appareil. Définissez
gl,hl,locationetdevicepour correspondre à ce avec quoi vous comparez ; voir localisations et langues.
Où sont publiés les incidents et les changements ?
Dans le changelog. Chaque entrée indique une date, ce qui a été affecté (un moteur, un champ, l'espace client ou les paiements) et ce qui a changé. Un champ ajouté y apparaît aussi, afin qu'un parser puisse être mis à jour avant d'avoir besoin du champ.
Nous n'exploitons pas de site de statut séparé, et cette page n'affiche aucun voyant vert qui pourrait être périmé. La vérification gratuite ci-dessus vous indique l'état réel de l'API pour votre clé, au moment où vous la lancez.
Pourquoi n'y a-t-il pas de pourcentage de disponibilité ici ?
Parce que nous n'en avons pas encore mesuré avec une méthode publiée. Un chiffre de disponibilité suppose une sonde définie, une période définie et une défaillance définie. Quand nous l'aurons, il apparaîtra ici avec sa méthode et sa date. D'ici là, la promesse honnête est la règle de facturation : 1 crédit = 1 requête réussie, qui renvoie une page de résultats sur n'importe quel moteur pris en charge. Une requête qui échoue n'est pas facturée.
Que faut-il envoyer au support pendant un incident ?
Écrivez à [email protected] avec l'ID de requête fourni par search_metadata.id (ou l'heure de la requête s'il n'y a pas eu de réponse), le moteur, le statut HTTP et le code d'erreur. N'incluez jamais votre clé API. Réponses par email sous 12 heures, 7 jours sur 7, y compris pour l'aide à l'intégration de l'API. La page de contact liste les autres détails qui accélèrent une réponse.