Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Obtenir les résultats Amazon ASIN par id

Serveur:https://openapi.felo.ai
Bibliothèques clientes

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Obtenir les résultats Amazon ASIN par id

​

Une page produit Amazon, issue d'une tâche mise en file d'attente par post_dataforseo_merchant_amazon_asin_submit. Renvoie asin, se_domain, location_code, language_code, check_url, datetime, item_types, items_count et items, chaque élément portant title, details, image_url, author, data_asin, parent_asin et product_asins — ce dernier champ correspond à la famille de variantes, qui permet de trouver les autres tailles ou couleurs. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. N'y recourez que lorsque le résultat analysé ne contient pas un élément que vous pouvez désigner précisément.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.012.
  • Multiplicateur de référence client : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de chemin
  • id
    Type: string
    obligatoire

    identifiant de la tâche
    identifiant unique de la tâche dans notre système au format UUID
    vous pourrez l'utiliser pendant 30 jours pour demander les résultats de la tâche à tout moment

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo
    • cost
      Type: number | null Format: double

      coût total des tâches, USD

    • status_code
      Type: integer | null

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici

    • status_message
      Type: string | null

      message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

    • tasks
      Type: array (object | null)[] | null

      tableau de tâches

      • Type: object | null · Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo
        • cost
          Type: number | null Format: double

          coût total des tâches, USD

        • data
          Type: object | null

          contient les mêmes paramètres que ceux spécifiés dans la requête POST

          • propertyName
            Type: object | null
        • id
          Type: string | null

          identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

        • path
          Type: array (string | null)[] | null

          chemin de l'URL

        • result
          Type: array (object | null)[] | null

          tableau de résultats

          • asin
            Type: string | null

            ASIN reçu dans un tableau POST
            l'identifiant produit unique dans Amazon (ASIN) reçu dans un tableau POST
            en savoir plus sur l'identifiant dans ce guide du centre d'aide

          • check_url
            Type: string | null

            URL directe vers les résultats Amazon
            vous pouvez l'utiliser pour vous assurer que nous fournissons des résultats exacts

          • datetime
            Type: string | null

            date et heure de réception du résultat
            au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
            exemple :
            2019-11-15 12:57:46 +00:00

          • item_types
            Type: array (string | null)[] | null

            types de résultats de recherche trouvés sur Amazon
            contient les types de tous les résultats de recherche (items) trouvés dans le SERP renvoyé
            types d'éléments possibles :
            amazon_product_info

          • items
            Type: array (object | null)[] | null

            éléments d'informations produit Amazon

            • applicable_vouchers
              Type: array (object | null)[] | null

              tableau d'objets contenant des informations sur les bons applicables

              • fixed_discount
                Type: number | null

                valeur de la remise fixe

              • fixed_discount_currency
                Type: string | null

                code de devise de la remise fixe

              • important_details
                Type: string | null

                détails importants sur les conditions des bons de réduction

              • percentage_discount
                Type: number | null

                valeur de la remise en pourcentage
                si la remise est fixe, la valeur sera null

              • text
                Type: string | null

                texte du bon

              • type
                Type: string | null

                type d'élément

            • author
              Type: string | null

              nom de la marque du produit

            • categories
              Type: array (object | null)[] | null

              contient les catégories de produits associées

              • category
                Type: string | null

                nom de la catégorie de produit

              • url
                Type: string | null

                URL de la catégorie de produit
                indique le chemin de navigation sur Amazon avec l'ID de nœud de navigation unique (ID de catégorie de produit sur Amazon)

            • currency
              Type: string | null

              devise au format ISO
              exemple :
              USD

            • data_asin
              Type: string | null

              ASIN du produit reçu dans un tableau POST

            • description
              Type: string | null

              contient la description du produit

            • details
              Type: string | null

              caractéristiques du produit et autres détails

            • image_url
              Type: string | null

              l'URL de l'image du produit

            • is_amazon_choice
              Type: boolean | null

              label "Amazon's choice"
              si la valeur est true, le produit porte le label "Amazon's choice"

            • is_available
              Type: boolean | null

              indique si le produit est disponible à la commande
              si la valeur est true, le produit peut être commandé

            • is_newer_model_available
              Type: boolean | null

              indique si le nouveau modèle du produit est disponible

            • is_prime_video
              Type: boolean | null

              indique si un produit possède le label Amazon Prime Video
              si true, le produit indiqué fait partie du service Amazon Prime Video

            • newer_model
              Type: object | null · Response36Afe1097B20_NewerModel

              informations sur le nouveau modèle du produit

              • newer_model_asin
                Type: string | null

                ASIN du modèle de produit le plus récent

              • title
                Type: string | null

                titre du produit

            • parent_asin
              Type: string | null

              ASIN parent du produit

            • percentage_discount
              Type: string | null

              valeur de la remise en pourcentage

            • position
              Type: string | null

              l'alignement de l'élément dans les SERP Amazon
              valeurs possibles :
              left, right

            • price_from
              Type: number | null

              la limite inférieure de la plage de prix du produit
              exemple :
              49.98

            • price_to
              Type: number | null

              la limite supérieure de la plage de prix du produit
              exemple :
              384.99

            • product_asins
              Type: array (string | null)[] | null

              ASIN de toutes les variantes trouvées du produit

            • product_images_list
              Type: array (string | null)[] | null

              contient les URL de toutes les images du produit affichées à gauche de l'image principale

            • product_information
              Type: array (object | null)[] | null

              contient des informations associées sur le produit

              • section_name
                Type: string | null

                nom de la section liée aux informations produit indiquées dans contents

              • type
                Type: string | null

                type d'élément

            • product_videos_list
              Type: array (string | null)[] | null

              contient les URL de toutes les vidéos du produit affichées à droite de la vidéo principale

            • rank_absolute
              Type: integer | null

              rang absolu
              position absolue parmi tous les éléments du tableau de réponse

            • rank_group
              Type: integer | null

              position au sein d'un groupe d'éléments ayant des valeurs type identiques
              les positions des éléments ayant des valeurs type différentes sont omises de rank_group

            • rating
              Type: object | null · Response36Afe1097B20_RatingElement

              informations de notation du produit

              • position
                Type: string | null

                l'alignement de l'élément dans la SERP Google Shopping
                valeurs possibles :
                left, right

              • rating_max
                Type: integer | null

                la valeur maximale d'un rating_type

              • rating_type
                Type: string | null

                le type de note
                vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

              • type
                Type: string | null

                type d'élément

              • value
                Type: number | null

                valeur de la note

              • votes_count
                Type: integer | null Format: int64

                la quantité d'avis

            • title
              Type: string | null

              titre du produit

            • top_global_reviews
              Type: array (object | null)[] | null

              tableau d'objets contenant les meilleurs avis du monde entier

              • helpful_votes
                Type: string | null

                nombre de votes utiles
                nombre d'utilisateurs ayant cliqué sur le bouton 'Helpful" sous le texte de l'avis

              • images
                Type: array (object | null)[] | null

                images du produit soumises par l'auteur de l'avis

                • alt
                  Type: string | null

                  balise alt de l'image

                • image_url
                  Type: string | null

                  URL de l'image
                  l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible)

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL pertinente

              • position
                Type: string | null

                l'alignement de l'avis dans la SERP
                peut prendre les valeurs suivantes : right

              • publication_date
                Type: string | null

                date et heure de publication de l'avis
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” ;
                exemple :
                2019-11-15 12:57:46 +00:00

              • rank_absolute
                Type: integer | null

                rang absolu parmi tous les avis listés
                position absolue parmi tous les avis de la liste

              • rank_group
                Type: integer | null

                position au sein d'un groupe d'éléments ayant des valeurs type identiques
                les positions des éléments ayant des valeurs type différentes sont omises de rank_group

              • rating
                Type: object | null · Response36Afe1097B20_RatingInfo

                la note soumise par l'auteur de l'avis

                • rating_max
                  Type: integer | null

                  la valeur maximale d'un rating_type

                • rating_type
                  Type: string | null

                  le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

                • value
                  Type: number | null Format: double

                  la valeur de la note

                • votes_count
                  Type: integer | null Format: int64

                  la quantité d'avis

              • review_text
                Type: string | null

                contenu de l'avis

              • subtitle
                Type: string | null

                sous-titre de l'avis

              • title
                Type: string | null

                titre de l'avis

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null
              • user_profile
                Type: object | null · Response36Afe1097B20_UserProfileInfo

                profil utilisateur de l'auteur de l'avis

                • avatar
                  Type: string | null
                • locations
                  Type: string | null
                • name
                  Type: string | null
                • reviews_count
                  Type: integer | null Format: int64

                  Signed 64-bit integers (long type).

                • url
                  Type: string | null

                  URL pertinente

              • verified
                Type: boolean | null

                indique si l'avis porte la mention "Verified Purchase"

              • videos
                Type: array (object | null)[] | null

                vidéos du produit soumises par l'auteur de l'avis

                • preview
                  Type: string | null

                  URL de l'image d'aperçu de la vidéo

                • source
                  Type: string | null

                  URL de la source de la vidéo

                • timestamp
                  Type: string | null

                  date et heure de publication du résultat
                  au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                  exemple :
                  2019-11-15 12:57:46 +00:00

                • title
                  Type: string | null

                  titre d'un élément de lien donné

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL source

              • xpath
                Type: string | null

                le XPath de l'élément

            • top_local_reviews
              Type: array (object | null)[] | null

              tableau d'objets contenant les meilleurs avis de la localisation cible

              • helpful_votes
                Type: string | null

                nombre de votes utiles
                nombre d'utilisateurs ayant cliqué sur le bouton 'Helpful" sous le texte de l'avis

              • images
                Type: array (object | null)[] | null

                images du produit soumises par l'auteur de l'avis

                • alt
                  Type: string | null

                  balise alt de l'image

                • image_url
                  Type: string | null

                  URL de l'image
                  l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible)

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL pertinente

              • position
                Type: string | null

                l'alignement de l'avis dans la SERP
                peut prendre les valeurs suivantes : right

              • publication_date
                Type: string | null

                date et heure de publication de l'avis
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” ;
                exemple :
                2019-11-15 12:57:46 +00:00

              • rank_absolute
                Type: integer | null

                rang absolu parmi tous les avis listés
                position absolue parmi tous les avis de la liste

              • rank_group
                Type: integer | null

                position au sein d'un groupe d'éléments ayant des valeurs type identiques
                les positions des éléments ayant des valeurs type différentes sont omises de rank_group

              • rating
                Type: object | null · Response36Afe1097B20_RatingInfo

                la note soumise par l'auteur de l'avis

                • rating_max
                  Type: integer | null

                  la valeur maximale d'un rating_type

                • rating_type
                  Type: string | null

                  le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

                • value
                  Type: number | null Format: double

                  la valeur de la note

                • votes_count
                  Type: integer | null Format: int64

                  la quantité d'avis

              • review_text
                Type: string | null

                contenu de l'avis

              • subtitle
                Type: string | null

                sous-titre de l'avis

              • title
                Type: string | null

                titre de l'avis

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null
              • user_profile
                Type: object | null · Response36Afe1097B20_UserProfileInfo

                profil utilisateur de l'auteur de l'avis

                • avatar
                  Type: string | null
                • locations
                  Type: string | null
                • name
                  Type: string | null
                • reviews_count
                  Type: integer | null Format: int64

                  Signed 64-bit integers (long type).

                • url
                  Type: string | null

                  URL pertinente

              • verified
                Type: boolean | null

                indique si l'avis porte la mention "Verified Purchase"

              • videos
                Type: array (object | null)[] | null

                vidéos du produit soumises par l'auteur de l'avis

                • preview
                  Type: string | null

                  URL de l'image d'aperçu de la vidéo

                • source
                  Type: string | null

                  URL de la source de la vidéo

                • timestamp
                  Type: string | null

                  date et heure de publication du résultat
                  au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                  exemple :
                  2019-11-15 12:57:46 +00:00

                • title
                  Type: string | null

                  titre d'un élément de lien donné

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL source

              • xpath
                Type: string | null

                le XPath de l'élément

            • type
              Type: string | null

              type d'élément

            • xpath
              Type: string | null

              le XPath de l'élément

          • items_count
            Type: integer | null Format: int64

            le nombre de résultats renvoyés dans le tableau items

          • language_code
            Type: string | null

            code de langue dans un tableau POST

          • location_code
            Type: integer | null

            code de localisation dans un tableau POST

          • se_domain
            Type: string | null

            domaine Amazon dans un tableau POST

          • type
            Type: string | null

            type d'élément

        • result_count
          Type: integer | null Format: int64

          nombre d'éléments dans le tableau de résultats

        • status_code
          Type: integer | null

          code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

        • status_message
          Type: string | null

          message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

        • time
          Type: string | null

          temps d'exécution, en secondes

    • tasks_count
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches

    • tasks_error
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

    • time
      Type: string | null

      temps d'exécution total, en secondes

    • version
      Type: string | null

      la version actuelle de l'API

    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    application/json
Request Example for get/v1/beta/dataforseo/merchant/amazon/asin/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/asin/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "asin": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "title": null,
              "details": null,
              "image_url": null,
              "author": null,
              "data_asin": null,
              "parent_asin": null,
              "product_asins": [
                "[Max Depth Exceeded]"
              ],
              "price_from": null,
              "price_to": null,
              "percentage_discount": null,
              "currency": null,
              "is_amazon_choice": null,
              "rating": "[Max Depth Exceeded]",
              "is_newer_model_available": null,
              "is_prime_video": null,
              "applicable_vouchers": [
                "[Max Depth Exceeded]"
              ],
              "newer_model": "[Max Depth Exceeded]",
              "categories": [
                "[Max Depth Exceeded]"
              ],
              "product_information": [
                "[Max Depth Exceeded]"
              ],
              "product_images_list": [
                "[Max Depth Exceeded]"
              ],
              "product_videos_list": [
                "[Max Depth Exceeded]"
              ],
              "description": null,
              "is_available": null,
              "top_local_reviews": [
                "[Max Depth Exceeded]"
              ],
              "top_global_reviews": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}
Get Amazon ASIN Results by id