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

Configurer les tâches ‘DataForSEO Search Volume’ en temps réel

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 ‘DataForSEO Search Volume’ en temps réel

​

Volume de recherche dérivé de panels clickstream plutôt que des plateformes publicitaires, pour une liste de keywords. use_clickstream active ou désactive le mélange. Renvoie location_code, language_code, use_clickstream, items_count et items. 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. Le volume clickstream diverge souvent de post_dataforseo_keywords_gads_search_volume_live, et c'est justement l'intérêt : l'un mesure ce qui est montré aux annonceurs, l'autre ce que les gens ont fait.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.09.
  • Multiplicateur client de référence : 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)[]
    • keywords
      Type: array string[]

      mots-clés cibles
      champ obligatoire
      encodage UTF-8
      nombre maximal de mots-clés que vous pouvez indiquer dans ce tableau : 1000
      les mots-clés sont convertis en minuscules

      Remarque : certains symboles et caractères (par exemple, les symboles UTF, les emojis) ne sont pas autorisés
      pour savoir quels symboles et caractères peuvent être utilisés, consultez cet article

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

    • language_code
      Type: string

      code de langue du moteur de recherche
      champ obligatoire si vous ne spécifiez pas language_name
      vous pouvez recevoir la liste des langues disponibles avec leur language_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      exemple :
      en

    • language_name
      Type: string

      nom complet de la langue du moteur de recherche
      champ obligatoire si vous ne spécifiez pas language_code
      vous pouvez recevoir la liste des langues disponibles avec leur language_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      exemple :
      English

    • location_code
      Type: integer

      code d'emplacement du moteur de recherche
      champ obligatoire si vous ne spécifiez pas location_name
      si vous utilisez ce champ, vous pouvez recevoir la liste des emplacements disponibles avec location_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      exemple :
      2826

    • location_name
      Type: string

      nom complet de l'emplacement du moteur de recherche
      champ obligatoire si vous ne spécifiez pas location_code
      vous pouvez recevoir la liste des emplacements disponibles avec location_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      exemple :
      United Kingdom

    • 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

    • use_clickstream
      Type: boolean | null

      utiliser les données de clickstream pour fournir les résultats
      champ facultatif
      si la valeur est true, vous recevrez des valeurs de volume de recherche DataForSEO basées sur les données de clickstream ;
      si la valeur est false, les données de volume de recherche Bing seront utilisées pour calculer le volume de recherche DataForSEO ;
      valeur par défaut : true ;
      Remarque : le volume de recherche Bing est disponible pour les emplacements fournis dans les points de terminaison Bing Search Volume History Locations et Bing Ads Locations ; les valeurs de volume de recherche de tout autre emplacement sont calculées à partir des données de clickstream même si vous définissez ce paramètre sur false

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

            tableau de mots-clés
            contient des mots-clés et leurs taux de volume de recherche

            • keyword
              Type: string | null

              mot-clé fourni dans le tableau POST

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

              taux mensuels de volume de recherche
              tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année

              • month
                Type: integer | null

                mois

              • search_volume
                Type: integer | null

                taux moyen mensuel de volume de recherche

              • year
                Type: integer | null

                année

            • search_volume
              Type: integer | null Format: int64

              taux actuel de volume de recherche d'un mot-clé

          • items_count
            Type: integer | null

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

          • language_code
            Type: string | null

            code de langue dans un tableau POST

            Remarque :si le mot-clé du tableau POST semble mal orthographié, les données seront renvoyées pour le mot-clé correctement orthographié ;
            nous utilisons les fonctionnalités de l'API Google Ads pour vérifier et valider l'orthographe des mots-clés, en savoir plus via ce lien

          • location_code
            Type: integer | null

            code d'emplacement dans un tableau POST
            s'il n'y a pas de données, la valeur est null

          • use_clickstream
            Type: boolean | null

            indique si le paramètre use_clickstream est actif
            valeurs possibles : true, false

        • 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/keywords_data/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Setting Live ‘DataForSEO Search Volume’ Tasks