Docs

Premiers pas

De l’inscription à vos premières données en direct en quelques minutes. Vous envoyez une adresse web ou un terme de recherche avec votre clé API, et vous recevez les données en JSON. Puis un bref aperçu des erreurs, des limites et du cache.

Trois étapes

1
Créez votre compte
Saisissez votre adresse e-mail, confirmez-la avec le lien que nous vous envoyons et définissez un mot de passe. Créer un compte gratuit
2
Copiez votre clé API
Lors de votre première visite, le tableau de bord crée une clé nommée « default » et l’affiche une seule fois. Copiez-la et conservez-la en lieu sûr.
3
Envoyez votre première requête
Cliquez sur Essayer dans le démarrage rapide du tableau de bord, ou exécutez la requête ci-dessous avec votre clé.

Votre clé API

Envoyez votre clé avec chaque requête dans l’en-tête x-api-key. Les clés commencent par ds_. Nous ne stockons qu’une empreinte de chaque clé : elle n’est donc affichée en entier qu’une seule fois, à sa création. Conservez-la dans un gestionnaire de secrets, jamais dans du code exécuté dans un navigateur. Vous pouvez créer d’autres clés et révoquer les anciennes sous Clés API.

x-api-key: ds_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL de base : https://api.everydata.io.

Votre première requête

Recherchez « wireless headphones » sur Amazon. C’est la même requête que le bouton Essayer du tableau de bord, où votre clé est déjà renseignée juste après sa création. withCache=true autorise une réponse datant de 10 minutes au plus, ce qui la rend rapide.

GET /amz/amazon-search-by-keyword-asin

curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?domainCode=com&keyword=wireless+headphones&page=1&withCache=true" \
  -H "x-api-key: YOUR_API_KEY"

Ce que vous recevez

Chaque réponse réussie est un JSON qui commence par les deux mêmes champs, responseStatus et responseMessage, suivis des données de l’endpoint. Les résultats paginés ajoutent currentPage, nextPage et lastPage.

200 OK

{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "domainCode": "com",
  "keyword": "wireless headphones",
  "foundProducts": [
    "…"
  ],
  "searchProductDetails": [
    "…"
  ]
}

Erreurs

Les erreurs renvoient un petit corps JSON avec le statut HTTP et un message lisible. Seules les réponses réussies et les 404 (un « introuvable » valide) sont décomptées de votre quota.

400 Bad Request

{
  "statusCode": 400,
  "statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}

HTTP	Signification	Décompté
200	Succès. Les données suivent responseStatus et responseMessage.	Oui
400	Un paramètre obligatoire est manquant ou mal formaté.	Non
401	La clé API est manquante, erronée ou révoquée.	Non
403	Votre quota mensuel (ou la limite d’usage équitable) est épuisé.	Non
404	La page a été chargée, mais aucun produit ni aucune annonce ne correspond à votre saisie.	Oui
429	Trop de requêtes par minute. Le message indique combien de secondes attendre.	Non
502	Le site a bloqué cette tentative. Réessayez.	Non
503	Le site n’a pas pu être chargé. Réessayez.	Non

Limites et quota

Deux limites s’appliquent par compte : les requêtes par minute (de 10 à 750 selon l’offre) et les requêtes par mois. Les deux sont partagées entre toutes les plateformes et toutes les clés de votre compte. Trop de requêtes par minute renvoient 429 ; lorsque le quota mensuel est épuisé, vous recevez 403 jusqu’à sa réinitialisation au début de la période de facturation suivante.

Les requêtes qui échouent parce qu’un site n’a pas pu être chargé (5xx) ne sont pas décomptées. Votre consommation actuelle figure sur la page d’utilisation ; la page tarifs liste les limites de chaque offre.

Cache

Par défaut, les réponses sont en direct. Lorsque la rapidité compte plus que la fraîcheur, plusieurs endpoints acceptent withCache=true ou cacheTtl (en secondes) et peuvent répondre à partir d’une copie récente. Une réponse en cache compte toujours pour une requête.

Ensuite : parcourez la référence complète de l’API.