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

Mots-clés associés

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

Mots-clés associés

​

Termes de recherche Amazon liés à un mot-clé de départ. Paginez avec limit, offset et offset_token ; utilisez le jeton au-delà des premières pages. 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. L'équivalent côté Google est post_dataforseo_labs_google_related_keywords_live ; l'intention d'achat et l'intention web divergent nettement, ne remplacez donc pas l'un par l'autre.

Référence tarifaire

  • Facturation : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.1356.
  • Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à 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)[]
    • depth
      Type: integer | null

      profondeur de recherche de mots-clés
      champ facultatif
      valeur par défaut : 1 ;
      le nombre de résultats renvoyés dépend de la valeur que vous définissez dans ce champ ;
      vous pouvez indiquer un niveau de 0 à 4 ;
      nombre estimé de mots-clés pour chaque niveau (maximum) :
      0 - le mot-clé défini dans le champ keyword
      1 – 6 mots-clés
      2 – 42 mots-clés
      3 – 258 mots-clés
      4 – 1554 mots-clés

    • ignore_synonyms
      Type: boolean | null

      ignorer les mots-clés très similaires
      champ facultatif
      s'il est défini sur true, seuls les mots-clés principaux sont renvoyés, tous les mots-clés très similaires sont exclus ;
      valeur par défaut : false

    • include_seed_keyword
      Type: boolean | null

      inclure les données du mot-clé de départ
      champ facultatif
      s'il est défini sur true, les données du mot-clé de départ indiqué dans le champ keyword seront fournies dans le tableau seed_keyword_data de la réponse
      valeur par défaut : false

    • keyword
      Type: string

      mot-clé
      champ obligatoire
      encodage UTF-8
      les mots-clés doivent être indiqués en minuscules

      en savoir plus sur les règles et limitations des champs keyword et keywords dans les API DataForSEO dans cet article du centre d'aide

    • language_code
      Type: string | null

      code de langue
      champ obligatoire si vous n'indiquez pas language_name
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des langues disponibles avec leur language_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      en

    • language_name
      Type: string

      nom complet de la langue
      champ obligatoire si vous n'indiquez pas language_code
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des langues disponibles avec leur language_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      English

    • limit
      Type: integer | null

      le nombre maximal de mots-clés renvoyés
      champ facultatif
      valeur par défaut : 100
      valeur maximale : 1000

    • location_code
      Type: integer

      code d'emplacement
      champ obligatoire si vous n'indiquez pas location_name
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur location_code en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
      Remarque : ce point de terminaison ne prend actuellement en charge que les emplacements des États-Unis, d'Égypte, d'Arabie saoudite et des Émirats arabes unis ;
      exemple :
      2840

    • location_name
      Type: string

      nom complet de l'emplacement
      champ obligatoire si vous n'indiquez pas location_code
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur location_name en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
      Remarque : ce point de terminaison ne prend actuellement en charge que les emplacements des États-Unis, d'Égypte, d'Arabie saoudite et des Émirats arabes unis ;
      exemple :
      United States

    • offset
      Type: integer | null

      décalage dans le tableau de résultats des mots-clés renvoyés
      champ facultatif
      valeur par défaut : 0
      si vous indiquez la valeur 10, les dix premiers mots-clés du tableau de résultats seront omis et les données seront fournies pour les mots-clés suivants

    • 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_DataforseoLabsAmazonRelatedKeywordsLiveResponseInfo
    • 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_DataforseoLabsAmazonRelatedKeywordsLiveTaskInfo
        • 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

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

            contient des objets avec des mots-clés et des données associées

            • depth
              Type: integer | null

              profondeur de recherche du mot-clé

            • keyword_data
              Type: object | null · Response36Afe1097B20_AmazonKeywordData

              données de mot-clé pour le mot-clé renvoyé

              • keyword
                Type: string | null

                mot-clé associé

              • keyword_info
                Type: object | null · Response36Afe1097B20_AmazonKeywordInfo

                informations sur le mot-clé pour le mot-clé renvoyé

                • last_updated_time
                  Type: string | null

                  date et heure de la mise à jour des données de mot-clé au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : '2019-11-15 12:57:46 +00:00'

                • se_type
                  Type: string | null

                  type de moteur de recherche

                • search_volume
                  Type: integer | null Format: int64

                  taux moyen mensuel de volume de recherche représente le nombre (approximatif) de recherches pour l'idée de mot-clé fournie sur Amazon

              • language_code
                Type: string | null

                code de langue dans un tableau POST

              • location_code
                Type: integer | null Format: int64

                code de localisation dans un tableau POST

              • se_type
                Type: string | null

                type de moteur de recherche

            • related_keywords
              Type: array string[] | null

              liste de mots-clés associés
              représente la liste des requêtes de recherche associées au mot-clé renvoyé dans le tableau ci-dessus

            • se_type
              Type: string | null

              type de moteur de recherche

          • 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_type
            Type: string | null

            type de moteur de recherche

          • seed_keyword
            Type: string | null

            mot-clé dans un tableau POST

          • seed_keyword_data
            Type: object | null · Response36Afe1097B20_AmazonKeywordData

            données de mot-clé pour le mot-clé initial
            les champs de l'objet sont identiques à ceux de keyword_data

            • keyword
              Type: string | null

              mot-clé associé

            • keyword_info
              Type: object | null · Response36Afe1097B20_AmazonKeywordInfo

              informations sur le mot-clé pour le mot-clé renvoyé

              • last_updated_time
                Type: string | null

                date et heure de la mise à jour des données de mot-clé au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : '2019-11-15 12:57:46 +00:00'

              • se_type
                Type: string | null

                type de moteur de recherche

              • search_volume
                Type: integer | null Format: int64

                taux moyen mensuel de volume de recherche représente le nombre (approximatif) de recherches pour l'idée de mot-clé fournie sur Amazon

            • language_code
              Type: string | null

              code de langue dans un tableau POST

            • location_code
              Type: integer | null Format: int64

              code de localisation dans un tableau POST

            • se_type
              Type: string | null

              type de moteur de recherche

          • total_count
            Type: integer | null Format: int64

            quantité totale de résultats de notre base de données correspondant à votre requête

        • 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/dataforseo_labs/amazon/related_keywords/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/related_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "computer mouse",
    "language_name": "English",
    "location_code": 2840,
    "limit": 5,
    "include_seed_keyword": true
  }
]'

{
  "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": [
        {
          "se_type": null,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "depth": null,
              "related_keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Related Keywords