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

Configurer les tâches Amazon Sellers

Felo API Support
MIT
Serveur:https://openapi.felo.ai
Bibliothèques clientes
Shell Curl

DataForSEO

​

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

DataForSEO Opérations

Configurer les tâches Amazon Sellers

​

Met en file d'attente la liste des vendeurs proposant un produit Amazon et renvoie un id de tâche. Cette famille est entièrement asynchrone : la soumission renvoie un id de tâche dans tasks[0].id et l'outil de récupération renvoie le résultat dès qu'il est prêt. ⚠️ Les points de terminaison Amazon exigent une langue au format locale — en_US, ou English (United States) — et rejettent le en seul accepté par les points de terminaison Google. L'omettre entièrement renvoie aussi Invalid Field: 'language_name' : ce message signifie donc une langue erronée ou absente, pas seulement erronée. get_dataforseo_merchant_amazon_languages répertorie les 27 paires valides. Récupérez avec get_dataforseo_merchant_amazon_sellers_fetch.

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.

Corps
application/json
  • Type: array (object | null)[]
    • asin
      Type: string

      identifiant unique du produit sur Amazon
      champ obligatoire
      vous pouvez obtenir cette valeur en effectuant une requête distincte sur le point de terminaison Amazon Products
      notez qu'il n'existe pas de liste complète des valeurs possibles, car les valeurs asin sont dynamiques et attribuées par Amazon
      exemple :
      B085RFFC9Q
      en savoir plus sur l'identifiant dans ce guide du centre d'aide

    • language_code
      Type: string

      code de langue
      champ obligatoire si vous ne spécifiez pas language_name
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name
      vous pouvez obtenir la liste des langues Amazon disponibles avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/amazon/languages
      exemple :
      en_US

    • language_name
      Type: string

      nom complet de la langue
      champ obligatoire si vous ne spécifiez pas language_code
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code
      vous pouvez obtenir la liste des langues Amazon disponibles avec leur language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/amazon/languages
      exemple :
      English (United States)

    • location_code
      Type: integer

      code d'emplacement
      champ obligatoire si vous ne spécifiez pas location_name ni location_coordinate
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_coordinate
      vous pouvez obtenir la liste des emplacements Amazon disponibles avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/amazon/locations
      exemple :
      2840

    • location_coordinate
      Type: string

      coordonnées GPS d'un emplacement
      champ obligatoire si vous ne spécifiez pas location_name ni location_code
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_code
      le paramètre location_coordinate doit être indiqué au format "latitude,longitude,radius"
      le nombre maximal de décimales pour "latitude" et "longitude" : 7
      la valeur minimale pour "radius" : 199.9
      exemple :
      53.476225,-2.243572,200

    • location_name
      Type: string

      nom complet de l'emplacement
      champ obligatoire si vous ne spécifiez pas location_code ni location_coordinate
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ni location_coordinate
      vous pouvez obtenir la liste des emplacements Amazon disponibles avec leur location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/amazon/locations
      exemple :
      London,England,United Kingdom

    • pingback_url
      Type: string | null

      URL de notification d'une tâche terminée
      champ facultatif
      lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée
      vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
      exemple :
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ;
      notamment, le caractère # sera encodé en %23

      en savoir plus dans notre centre d'aide

    • postback_data
      Type: string

      type de données de postback_url
      champ obligatoire si vous spécifiez postback_url
      correspond au type de données qui sera envoyé à votre serveur
      valeurs possibles :
      advanced, html

    • postback_url
      Type: string | null

      URL d'envoi des résultats de la tâche
      champ facultatif
      une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au format gzip à l'adresse postback_url que vous avez spécifiée
      vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
      exemple :
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Remarque : les caractères spéciaux de postback_url seront encodés pour URL ;
      notamment, le caractère # sera encodé en %23

      en savoir plus dans notre centre d'aide

    • priority
      Type: integer | null

      priorité de la tâche
      champ facultatif
      peut prendre les valeurs suivantes :
      1 – priorité d'exécution normale (définie par défaut)
      2 – priorité d'exécution élevée. Les tâches à priorité d'exécution élevée sont facturées en supplément.
      Le coût peut être calculé sur la page Tarifs.

    • se_domain
      Type: string | null

      domaine du moteur de recherche
      champ facultatif
      nous choisissons automatiquement le domaine du moteur de recherche pertinent en fonction de l'emplacement et de la langue que vous indiquez
      vous pouvez toutefois définir un domaine de moteur de recherche personnalisé dans ce champ
      exemple :
      amazon.co.uk, amazon.com.au, amazon.de, etc.

    • tag
      Type: string | null

      identifiant de tâche défini par l'utilisateur
      champ facultatif
      la limite est de 255 caractères
      vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
      vous trouverez la valeur tag spécifiée dans l'objet data de la réponse

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_MerchantAmazonSellersTaskPostResponseInfo
    • 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_MerchantAmazonSellersTaskPostTaskInfo
        • 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: object | null

          tableau de résultats
          dans ce cas, la valeur sera null

        • 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 post/v1/beta/dataforseo/merchant/amazon/sellers/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/sellers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "asin": "B085RFFC9Q"
  }
]'

{
  "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": null
    }
  ]
}

Opération réussie

Setting Amazon Sellers Tasks