20 % de remise sur toutes les offres payantes avec le code

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. 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. 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. 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.

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

Google Sheets et Excel (CSV)

Chaque endpoint de données existe aussi en CSV : ajoutez /csv devant son chemin. Comme une formule de tableur ne peut pas envoyer d'en-têtes, la clé peut être passée dans le paramètre de requête apiKey. Dans Google Sheets, une seule formule charge le tableau dans la feuille :

Google Sheets
=IMPORTDATA("https://api.everydata.io/csv/ott/otto-search-by-keyword?keyword=kaffeemaschine&fields=productDescription,price,dpUrl&apiKey=YOUR_API_KEY")

Chaque élément de la liste principale (résultats de recherche, avis, points d'historique …) devient une ligne ; un produit seul devient une ligne. Les champs imbriqués deviennent des colonnes avec un point dans le nom (mainImage.imageUrl), les listes de valeurs sont jointes par ; , les listes d'objets apparaissent en texte JSON. responseStatus et responseMessage ne sont pas des colonnes.

Options : fields=a,b,c choisit les colonnes et leur ordre, header=false supprime la ligne d'en-tête, rows=offers prend une autre liste comme lignes. Tous les autres paramètres sont transmis tels quels à l'endpoint.

Chaque appel – donc chaque fois que Google Sheets recharge la formule, en général environ une fois par heure – est une requête normale, avec le même quota, le même poids et les mêmes limites de débit que l'appel JSON. Les erreurs gardent leur statut HTTP et renvoient un CSV avec une colonne error, pour que la cellule affiche le message. Un texte qui commence par =, +, - ou @ reçoit une apostrophe devant, pour que le tableur ne l'exécute jamais comme formule.

La clé dans l'URL est visible par toute personne qui peut ouvrir la feuille. Utilisez une clé distincte par feuille et révoquez-la sous Clés API si la feuille a été trop largement partagée. Dans Excel, utilisez Données → À partir du web avec la même URL. Pas à pas : guide Google Sheets.