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

Estimation de trafic en lot

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

Estimation de trafic en lot

​

Trafic organique estimé pour de nombreux domaines en un seul appel. Ce point de terminaison n'accepte pas de paramètre de limite, mais il est facturé par appel et non par élément : envoyez donc toute la liste d'un coup. 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 prix est par appel : c'est ainsi que l'on classe une liste de concurrents à moindre coût avant de consacrer des appels par domaine aux plus intéressants. La version historique est post_dataforseo_labs_google_historical_bulk_traffic_live.

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)[]
    • 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

    • item_types
      Type: array string[] | null

      afficher les résultats par type d'élément
      champ facultatif
      indique le type de résultats de recherche inclus dans la réponse

      Remarque : si le tableau item_types contient des types d'élément autres que organic, les résultats seront triés selon le premier type d'élément du tableau

      valeurs possibles :
      ["organic", "paid", "featured_snippet", "local_pack"]
      valeur par défaut :
      ["organic", "paid"]

    • language_code
      Type: string | null

      code de langue
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name
      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
      ignorez ce champ pour obtenir les résultats de toutes les langues disponibles
      exemple :
      en

    • language_name
      Type: string | null

      nom complet de la langue
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier 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
      ignorez ce champ pour obtenir les résultats de toutes les langues disponibles
      exemple :
      English

    • location_code
      Type: integer | null

      code d'emplacement
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name
      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
      ignorez ce champ pour obtenir les résultats de tous les emplacements disponibles
      exemple :
      2840

    • location_name
      Type: string | null

      nom complet de l'emplacement
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier 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
      ignorez ce champ pour obtenir les résultats de tous les emplacements disponibles
      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

    • targets
      Type: array string[]

      domaines, sous-domaines et pages web cibles
      champ obligatoire
      vous pouvez indiquer des domaines, des sous-domaines et des pages web dans ce champ ;
      les domaines et sous-domaines doivent être indiqués sans https:// ni www. ;
      les pages doivent être indiquées avec une URL absolue, y compris https:// et www. ;
      vous pouvez définir jusqu'à 1000 domaines, sous-domaines ou pages web

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResponseInfo
    • 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_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo
        • 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 d'éléments avec les données d'estimation de trafic pertinentes

            • metrics
              Type: object | null · Response36Afe1097B20_BulkMetricsBundleInfo

              données de trafic relatives au domaine spécifié

              • featured_snippet
                Type: object | null · Response36Afe1097B20_BulkMetricsInfo

                données de trafic issues des résultats d'extraits enrichis dans le SERP Google

                • count
                  Type: integer | null Format: int64

                  nombre total de SERP organiques contenant le domaine

                • etv
                  Type: number | null

                  volume de trafic estimé
                  trafic organique mensuel estimé vers le domaine
                  calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
                  en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

              • local_pack
                Type: object | null · Response36Afe1097B20_BulkMetricsInfo

                données de trafic issues des résultats du pack local dans le SERP

                • count
                  Type: integer | null Format: int64

                  nombre total de SERP organiques contenant le domaine

                • etv
                  Type: number | null

                  volume de trafic estimé
                  trafic organique mensuel estimé vers le domaine
                  calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
                  en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

              • organic
                Type: object | null · Response36Afe1097B20_BulkMetricsInfo

                données de trafic issues de la recherche organique

                • count
                  Type: integer | null Format: int64

                  nombre total de SERP organiques contenant le domaine

                • etv
                  Type: number | null

                  volume de trafic estimé
                  trafic organique mensuel estimé vers le domaine
                  calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
                  en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

              • paid
                Type: object | null · Response36Afe1097B20_BulkMetricsInfo

                données de trafic issues de la recherche payante

                • count
                  Type: integer | null Format: int64

                  nombre total de SERP organiques contenant le domaine

                • etv
                  Type: number | null

                  volume de trafic estimé
                  trafic organique mensuel estimé vers le domaine
                  calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
                  en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

            • se_type
              Type: string | null

              type de moteur de recherche

            • target
              Type: string | null

              domaine cible dans un tableau POST

          • 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
            s'il n'y a pas de données, la valeur est null

          • 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

          • 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/google/bulk_traffic_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "dataforseo.com",
      "cnn.com",
      "forbes.com"
    ],
    "location_code": 2840,
    "language_code": "en",
    "item_types": [
      "organic",
      "paid"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "target": null,
              "metrics": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Bulk Traffic Estimation