Obtenir votre quota et vos limites

Votre offre, votre quota de révélations, votre limite de requêtes et votre budget quotidien. Cet appel ne consomme rien, ce qui en fait le bon appel pour tester une clé.

GEThttps://findbytown.com/api/v1/quotaSans quota

Exemples

curl "https://findbytown.com/api/v1/quota" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

const res = await fetch("https://findbytown.com/api/v1/quota", {
  headers: { Authorization: "Bearer fbt_EXAMPLE_not_a_real_key_0000" },
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);
console.log(body);

import requests

res = requests.get(
    "https://findbytown.com/api/v1/quota",
    headers={"Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"},
)
body = res.json()
if not res.ok:
    raise RuntimeError(body["error"])
print(body)

Réponse

Exemple avec des valeurs fictives :

{
  "data": {
    "plan": "example",
    "used": 12,
    "allowance": 10000,
    "remaining": 9988,
    "resetAt": "2030-01-01T00:00:00.000Z",
    "rateLimit": {
      "perMinute": 60
    },
    "budget": {
      "companiesPerDay": 200000,
      "usedToday": 340
    },
    "pagination": {
      "maxPage": 200,
      "perPageMax": 50
    }
  }
}

Erreurs

Code	Statut HTTP	Signification
missing_api_key	401	En-tête Authorization absent ou vide.
invalid_api_key	401	La clé n’existe pas ou a été révoquée.
plan_without_api	403	L’offre actuelle du compte n’inclut pas l’API. S’applique dès la fin d’une offre.
suspended	403	Le compte est suspendu. Ses clés refonctionnent si la suspension est levée.
rate_limited	429	Trop de requêtes cette minute. Attendez le nombre de secondes indiqué dans Retry-After.
blocked	429	L’accès aux données d’entreprises est temporairement suspendu en raison d’un usage automatisé, comme le parcours des identifiants. Retry-After indique le temps restant. Écrivez au support s’il s’agit d’une erreur.
internal_error	500	Une erreur s’est produite de notre côté. Indiquez requestId en écrivant au support.

Retour à findbytown