v0.2.0-beta

OpenAPI 3.1.0

Obtenir les résultats ‘Ads Traffic By Keywords’ par id

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

get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}

Obtenir les résultats ‘Ads Traffic By Keywords’ par id

Récupère par id une prévision de trafic Google Ads mise en file d'attente : impressions, clics, coût et position moyenne projetés pour l'enchère que vous avez indiquée. 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. Contrairement aux points de terminaison de volume, il s'agit d'une projection, pas d'une mesure — les chiffres varient avec bid et match.

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_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo
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_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
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

average_cpc
Type: number | null Format: double

la valeur moyenne du coût par clic
représente le coût par clic (USD) estimé pour un mot-clé sur la base de la période indiquée et des données historiques ;
s'il n'y a pas de données, la valeur est null

bid
Type: number | null

l'enchère personnalisée maximale
l'enchère que vous avez indiquée lors de la configuration de la tâche
représente le prix que vous êtes prêt à payer pour une annonce
plus la valeur indiquée est élevée, plus les métriques et le coût reçus dans la réponse sont élevés
en savoir plus dans cet article du centre d'aide

clicks
Type: number | null

nombre de clics sur une annonce
nombre de clics qu'une annonce devrait recevoir au cours de la période indiquée
s'il n'y a pas de données, la valeur est null

cost
Type: number | null

coût d'une annonce
montant qui sera facturé pour la diffusion d'une annonce au cours de la période indiquée
s'il n'y a pas de données, la valeur est null

ctr
Type: number | null Format: double

taux de clics (CTR) prévu de l'annonce
nombre de clics qu'une annonce devrait recevoir divisé par le nombre d'impressions de l'annonce ;
Remarque : paramètre obsolète, la valeur est toujours null

date_interval
Type: string | null

intervalle de dates de prévision dans un tableau POST

impressions
Type: integer | null

nombre prévu d'impressions de l'annonce
nombre d'impressions qu'une annonce devrait recevoir au cours de la période indiquée
Remarque : paramètre obsolète, la valeur est toujours null

keyword
Type: string | null

mot-clé dans un tableau POST
les métriques sont fournies pour tous les mots-clés indiqués dans le tableau POST

language_code
Type: string | null

code de langue dans un tableau POST
s'il n'y a pas de données, la valeur est_nulln

location_code
Type: integer | null

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

match
Type: string | null

type de correspondance des mots-clés
peut prendre les valeurs suivantes : exact, broad, phrase

search_partners
Type: boolean | null

inclure les partenaires de recherche Google
la valeur est toujours 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

get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Afficher le schéma

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

Opération réussie

Obtenir les résultats ‘Ads Traffic By Keywords’ par id

AuthentificationRequired

DataForSEO

Obtenir les résultats ‘Ads Traffic By Keywords’ par id

Référence tarifaire