FAQ de l’API SE Ranking

Q Je reçois une erreur 402 "Insufficient Funds", mais mon tableau de bord affiche des crédits disponibles. Quel est le problème ?

A Cette erreur est renvoyée avec le message Insufficient funds, API key is temporarily disabled. Il s’agit du problème le plus fréquent rencontré par les nouveaux clients. Cela signifie généralement que votre clé API n’est pas encore entièrement liée à vos crédits. Cela peut se produire juste après un achat ou après un changement d’abonnement. Attendez quelques minutes puis réessayez. Si l’erreur persiste plus de 10 minutes, contactez-nous et notre équipe support vous aidera à résoudre le problème.

Q Je reçois une erreur 401 Unauthenticated. Qu’est-ce que cela signifie ?

A L’erreur 401 correspond à un échec d’authentification, et non à un problème de crédits. La requête ne contenait pas de clé API valide : le solde du compte n’entre donc pas en jeu et vous pouvez recevoir un 401 même avec un API Wallet entièrement approvisionné.

À vérifier :

• la clé est envoyée dans la requête exactement telle qu’elle apparaît dans le tableau de bord API, sans troncature ni espace superflu ;
• la clé existe toujours : une clé supprimée ou régénérée cesse immédiatement d’authentifier ;
• vous utilisez le type de clé attendu par l’endpoint (voir Puis-je utiliser la même clé API pour les endpoints Data et Project ?).

Si la clé est correcte et à jour et que vous recevez toujours un 401, contactez-nous en précisant le nom de la clé et l’horodatage d’une requête en échec.

Q Je reçois une erreur 403, mais mon API Wallet affiche des crédits disponibles. Qu’est-ce que cela signifie ?

A L’erreur 403 signifie que le compte n’a pas actuellement accès à la Data API, ce qui est indépendant du solde présent dans le Wallet. L’accès à la Data API provient d’un abonnement ou d’un module complémentaire actif ; un solde de Wallet à lui seul n’est pas pris en compte. Un compte peut donc disposer de crédits et se voir malgré tout refuser l’accès.

À vérifier :

• si le plan ou le module complémentaire qui donne accès à la Data API est toujours actif, et n’a pas expiré ni été rétrogradé ;
• si vous appelez depuis un sous-compte ou un compte client d’agence plutôt que depuis le compte principal qui détient l’accès ;
• le tableau de bord API, qui indique l’accès à la Data API et le solde du Wallet comme deux éléments distincts.

Si le module complémentaire semble actif et que vous obtenez toujours un 403, contactez-nous et nous vérifierons l’accès du compte.

Q Puis-je utiliser la même clé API pour les endpoints Data et Project ?

A Oui. Une seule clé API authentifie les requêtes vers les endpoints Data et Project. Les deux types d’endpoints sont accessibles via api.seranking.com grâce au gateway Data API, vous n’avez donc pas besoin d’une clé Project API distincte.

Q J’ai atteint une limite de requêtes lors de mes tests. Comment connaître les limites de mon abonnement ?

A Les limites de requêtes varient selon l’abonnement et peuvent être atteintes rapidement lors de tests à grande échelle. Les limites de votre plan sont indiquées dans la documentation. Nous vous recommandons de les vérifier avant d’exécuter des requêtes en volume afin d’adapter la fréquence de vos appels.

Q Comment savoir combien de crédits coûte chaque appel API ?

A Le coût en crédits dépend de l’endpoint utilisé. Avant d’exécuter des tâches importantes, consultez les tarifs par endpoint dans la documentation afin d’estimer votre consommation. Vous pouvez également suivre votre solde de crédits à tout moment dans le tableau de bord API.

Q Le message « Votre abonnement n’inclut pas de crédits API. Mettez à niveau votre plan ou rechargez votre solde pour commencer. » s’affiche. Qu’est-ce que cela signifie ?

A Cela signifie que votre abonnement ou solde actuel n’inclut pas encore de crédits Data API. Pour commencer à effectuer des appels, passez à un plan incluant des crédits Data API ou rechargez le solde de votre compte, puis créez ou conservez votre clé API. Si vous pensez que des crédits devraient déjà être disponibles, contactez-nous.

Q Comment suivre l’utilisation de mes crédits API et voir le coût de chaque requête ?

A Vous pouvez suivre votre solde de crédits à tout moment dans le tableau de bord API, et les coûts par endpoint sont indiqués dans la documentation afin que vous puissiez estimer votre consommation avant les tâches importantes.

Q J’ai acheté du solde, mais la Data API affiche toujours "No API access". Pourquoi ?

A Le solde d’un compte SE Ranking finance les outils à l’usage de SE Ranking (comme le Groupeur de mots-clés et le Vérificateur de volume de recherche). Il ne réactive pas l’accès à la Data API sur un compte dont l’essai a expiré. La Data API nécessite un abonnement payant actif incluant des crédits API ou des crédits API dédiés facturés à l’usage. Si votre essai est terminé, ajouter du solde ne suffit pas à rétablir l’accès à la Data API. Passez à un plan incluant des crédits Data API ou achetez des crédits API dédiés facturés à l’usage. Si vous pensez que l’accès à l’API devrait déjà être actif, contactez-nous.

Q Comment fonctionnent les crédits de l’API Wallet (facturés à l’usage) et dans quel ordre mes crédits sont-ils utilisés ?

A L’API Wallet contient des crédits Data API dédiés facturés à l’usage et il est distinct du solde général de votre compte SE Ranking (qui finance les outils à l’usage comme le Groupeur de mots-clés et le Vérificateur de volume de recherche). Contrairement à ce solde général, les crédits de l’API Wallet donnent bien accès à la Data API. Une première recharge de l’API Wallet peut activer la Data API même si votre abonnement ou votre essai a expiré.

Où le trouver : le solde de votre API Wallet s’affiche sur la carte principale du tableau de bord API ainsi que dans une section dédiée, « Wallet », où vous pouvez recharger, configurer la recharge automatique, activer les alertes de solde faible et consulter votre historique des transactions. La recharge automatique et les alertes de solde faible sont affichées comme « Coming soon » sur la page « Wallet » et ne peuvent pas encore être configurées.

Ordre d’utilisation des crédits : les crédits API inclus dans votre abonnement et dans les éventuels packs complémentaires sont utilisés en premier ; le solde de votre API Wallet n’est débité qu’une fois ces crédits inclus épuisés.

Vous venez de recharger mais l’accès n’apparaît pas ? Après un achat, les crédits sont appliqués en arrière-plan et votre solde se met à jour après un court délai ; l’accès peut donc ne pas apparaître immédiatement. Patientez un instant puis actualisez le tableau de bord API. Si un solde acheté n’apparaît toujours pas, contactez-nous.

Q Les crédits de l’API Wallet expirent-ils ou sont-ils réinitialisés chaque mois ?

A Non. Les crédits de l’API Wallet s’achètent sous forme de recharge ponctuelle facturée à l’usage. Ils n’expirent pas et ne sont pas réinitialisés au début d’une période de facturation : un solde de Wallet non utilisé est reporté jusqu’à ce que vous le dépensiez.

C’est l’inverse des crédits API inclus dans un abonnement ou un pack complémentaire, qui sont renouvelés à chaque cycle de facturation et ne sont pas reportés. Comme les crédits de l’abonnement et des packs sont utilisés en premier, votre solde de Wallet n’est généralement débité qu’une fois le quota renouvelable de la période épuisé.

Q Quels plans et types de comptes peuvent recharger l’API Wallet ?

A Aucune restriction liée au plan ne s’applique à l’achat de crédits API Wallet. Les comptes Core et Growth peuvent recharger l’API Wallet, tout comme les autres plans payants : la vérification porte sur le compte, pas sur le nom du plan.

La recharge n’est pas possible dans les cas suivants :

• vous êtes connecté à un sous-compte, auquel cas l’achat doit être effectué depuis le compte principal ;
• le compte est un compte client créé dans un espace de travail agence ;
• aucun abonnement n’est rattaché au compte ;
• les crédits n’auraient nulle part où être versés, par exemple avec un plan actif qui n’inclut aucun quota Data API.

Si vous pensez pouvoir effectuer une recharge et que l’option n’est pas disponible, contactez-nous et nous vérifierons votre compte.

Q Pourquoi mes crédits API Wallet n’apparaissent-ils pas dans la réponse de /account/subscription ?

A C’est le comportement attendu. L’endpoint /account/subscription ne renvoie que l’état de votre abonnement : le solde, le type et le fait qu’il ait expiré ou non. Il n’inclut pas les crédits de l’API Wallet, une recharge du Wallet ne modifie donc pas ce que renvoie cet endpoint. Consultez plutôt le solde de votre API Wallet dans le tableau de bord API. Si vous avez acheté des crédits Wallet et qu’ils n’y apparaissent pas non plus, contactez-nous.

Q Puis-je supprimer, régénérer ou restreindre une clé API ?

A Vous gérez vos clés dans le tableau de bord API, dans le tableau des clés API.

• Suppression : vous pouvez supprimer une clé Data API depuis le tableau des clés. Votre dernière clé Data API ne peut pas être supprimée. Créez d’abord une clé de remplacement, puis supprimez l’ancienne.
• Régénération : la clé Project API peut être régénérée, ce qui crée une nouvelle valeur et invalide l’ancienne. Mettez à jour toutes les intégrations qui l’utilisent juste après la régénération.
• Restriction : les clés API ne peuvent pas être limitées à un périmètre ni restreintes actuellement. Aucun paramètre ne permet de définir des listes d’adresses IP autorisées, des périmètres d’endpoints ou des permissions par clé. Une clé est créée avec un type et un nom uniquement. Si une clé a peut-être été exposée, supprimez-la ou régénérez-la plutôt que d’essayer d’en limiter la portée.

Si vous devez révoquer une clé en urgence, contactez-nous.