API Amazon

L'API Amazon vous permet de rechercher des produits et d'obtenir des informations détaillées sur un produit via son ASIN. Les deux endpoints prennent en charge le ciblage multi-région, la localisation de la devise et l'émulation d'appareil.

Endpoints

Endpoint	Description
`POST /api/v1/amazon/search`	Rechercher des produits Amazon avec tri, pagination et filtres de catégorie
`POST /api/v1/amazon/product`	Obtenir des informations détaillées sur un produit via son ASIN

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

Recherche de produits

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Recherchez des produits Amazon et obtenez des résultats structurés comprenant les prix, les évaluations et les détails du produit.

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. Requête de recherche (1 à 500 caractères).
`domain`	`string`	`com`	Suffixe du domaine Amazon (ex. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordre de tri. L'un des suivants : `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numéro de la page de départ (indexé à partir de 1).
`pages`	`integer`	`1`	Nombre de pages à retourner.
`category_id`	`string`	--	Identifiant de catégorie/département Amazon pour affiner les résultats.
`merchant_id`	`string`	--	Filtrer par un vendeur Amazon spécifique.
`country`	`string`	--	Code pays pour la localisation.
`language`	`string`	--	Code langue pour les résultats.
`currency`	`string`	--	Code monétaire ISO 4217 (ex. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Type d'appareil. L'un des suivants : `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Code postal pour les prix et la disponibilité localisés.
`autoselect_variant`	`boolean`	--	Sélectionner automatiquement la variante de produit par défaut.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Exemple de réponse

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Détails du produit

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Obtenez des informations détaillées pour un produit Amazon spécifique via son ASIN. Retourne le prix, la description, les spécifications, les images, les évaluations et les informations sur le vendeur.

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. ASIN Amazon (ex. `B09XS7JWHH`).
`domain`	`string`	`com`	Suffixe du domaine Amazon (ex. `com`, `co.uk`, `de`).
`country`	`string`	--	Code pays pour la localisation.
`language`	`string`	--	Code langue pour les résultats.
`currency`	`string`	--	Code monétaire ISO 4217 (ex. `USD`, `EUR`).
`device`	`string`	`desktop`	Type d'appareil. L'un des suivants : `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Code postal pour les prix localisés.
`autoselect_variant`	`boolean`	--	Sélectionner automatiquement la variante de produit par défaut.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Exemple de réponse

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Domaines pris en charge

Utilisez le paramètre domain pour cibler une place de marché Amazon spécifique :

Domaine	Place de marché
`com`	États-Unis
`co.uk`	Royaume-Uni
`de`	Allemagne
`fr`	France
`co.jp`	Japon
`ca`	Canada
`it`	Italie
`es`	Espagne
`in`	Inde
`com.au`	Australie
`com.br`	Brésil
`com.mx`	Mexique

Format de réponse

Les deux endpoints retournent une enveloppe de réponse cohérente :

Champ	Type	Description
`data`	`object \| null`	Le payload de la réponse. `null` si la requête a échoué en amont. La recherche retourne `{page, products, html}` ; le produit retourne directement l'objet produit.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé — clé API manquante ou invalide
`429`	Limite de taux ou d'utilisation dépassée pour votre plan
`502`	Erreur en amont — réessayez après un court délai
`503`	Amont indisponible — réessayez plus tard

Consultez Erreurs pour la référence complète des erreurs et les meilleures pratiques de réessai.

Liens connexes

Démarrage rapide — obtenez votre clé API et effectuez votre première requête
API Google Search — recherchez sur Google avec des données SERP structurées
API YouTube — recherchez des vidéos et extrayez des métadonnées
Limites de débit — limites par niveau de plan

API Amazon

Endpoints

Endpoint	Description
`POST /api/v1/amazon/search`	Rechercher des produits Amazon avec tri, pagination et filtres de catégorie
`POST /api/v1/amazon/product`	Obtenir des informations détaillées sur un produit via son ASIN

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

Recherche de produits

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Recherchez des produits Amazon et obtenez des résultats structurés comprenant les prix, les évaluations et les détails du produit.

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. Requête de recherche (1 à 500 caractères).
`domain`	`string`	`com`	Suffixe du domaine Amazon (ex. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordre de tri. L'un des suivants : `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numéro de la page de départ (indexé à partir de 1).
`pages`	`integer`	`1`	Nombre de pages à retourner.
`category_id`	`string`	--	Identifiant de catégorie/département Amazon pour affiner les résultats.
`merchant_id`	`string`	--	Filtrer par un vendeur Amazon spécifique.
`country`	`string`	--	Code pays pour la localisation.
`language`	`string`	--	Code langue pour les résultats.
`currency`	`string`	--	Code monétaire ISO 4217 (ex. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Type d'appareil. L'un des suivants : `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Code postal pour les prix et la disponibilité localisés.
`autoselect_variant`	`boolean`	--	Sélectionner automatiquement la variante de produit par défaut.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Exemple de réponse

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Détails du produit

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. ASIN Amazon (ex. `B09XS7JWHH`).
`domain`	`string`	`com`	Suffixe du domaine Amazon (ex. `com`, `co.uk`, `de`).
`country`	`string`	--	Code pays pour la localisation.
`language`	`string`	--	Code langue pour les résultats.
`currency`	`string`	--	Code monétaire ISO 4217 (ex. `USD`, `EUR`).
`device`	`string`	`desktop`	Type d'appareil. L'un des suivants : `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Code postal pour les prix localisés.
`autoselect_variant`	`boolean`	--	Sélectionner automatiquement la variante de produit par défaut.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Exemple de réponse

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Domaines pris en charge

Utilisez le paramètre domain pour cibler une place de marché Amazon spécifique :

Domaine	Place de marché
`com`	États-Unis
`co.uk`	Royaume-Uni
`de`	Allemagne
`fr`	France
`co.jp`	Japon
`ca`	Canada
`it`	Italie
`es`	Espagne
`in`	Inde
`com.au`	Australie
`com.br`	Brésil
`com.mx`	Mexique

Format de réponse

Les deux endpoints retournent une enveloppe de réponse cohérente :

Champ	Type	Description
`data`	`object \| null`	Le payload de la réponse. `null` si la requête a échoué en amont. La recherche retourne `{page, products, html}` ; le produit retourne directement l'objet produit.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé — clé API manquante ou invalide
`429`	Limite de taux ou d'utilisation dépassée pour votre plan
`502`	Erreur en amont — réessayez après un court délai
`503`	Amont indisponible — réessayez plus tard

Consultez Erreurs pour la référence complète des erreurs et les meilleures pratiques de réessai.

Liens connexes

Démarrage rapide — obtenez votre clé API et effectuez votre première requête
API Google Search — recherchez sur Google avec des données SERP structurées
API YouTube — recherchez des vidéos et extrayez des métadonnées
Limites de débit — limites par niveau de plan