v0.2.0-beta

OpenAPI 3.1.0

Configurer les tâches ‘Bing Ads Audience Estimation’ 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

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

Configurer les tâches ‘Bing Ads Audience Estimation’ en temps réel

Estime l'audience Bing Ads atteignable pour un bid et un daily_budget donnés, restreinte par location_code, age, secteur et fonction professionnelle. 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. Les valeurs de secteur et de fonction professionnelle proviennent de get_dataforseo_keywords_bing_audience_industries et get_dataforseo_keywords_bing_audience_job_functions — toutes deux gratuites, et toutes deux à lire avant de composer une requête. Les variantes de soumission et de récupération de ce point de terminaison effectuent le même travail de manière asynchrone, au même prix, pour les lots trop volumineux pour attendre.

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)[]
- age
  Type: array string[] | null
  
  sélection des tranches d'âge pour le ciblage
  valeurs possibles : eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve
- bid
  Type: number | null
  
  valeur souhaitée du paramètre d'enchère en USD
  valeur maximale : 1000
- daily_budget
  Type: number | null
  
  valeur du budget quotidien de la campagne en USD
  valeur maximale : 10000
- gender
  Type: array string[] | null
  
  genre à cibler
  valeurs possibles : male, female, unknown
- industry
  Type: array string[] | null
  
  secteur du ciblage des profils LinkedIn
  
  si vous utilisez ce champ, vous pouvez recevoir la liste des noms de secteurs disponibles avec industry_id en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  exemple : 806301758
- job_function
  Type: array string[] | null
  
  fonction professionnelle du ciblage des profils LinkedIn
  
  si vous utilisez ce champ, vous pouvez recevoir la liste des noms de fonctions professionnelles disponibles avec job_function_id en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  exemple : 806300451
- location_code
  Type: integer
  
  code d'emplacement du moteur de recherche
  champ obligatoire si vous ne spécifiez pas location_name ou location_coordinate
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_coordinate
  vous pouvez recevoir la liste des emplacements disponibles des moteurs de recherche avec leur location_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/bing/locations
  exemple :
  2840
- location_coordinate
  Type: string
  
  coordonnées GPS d'un emplacement
  champ obligatoire si vous ne spécifiez pas location_name ou location_code
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_code
  le paramètre location_coordinate doit être indiqué au format "latitude,longitude,rayon (en km)"
  les données sont fournies pour le pays auquel appartiennent les coordonnées indiquées
  exemple :
  29.6821525,-82.4098881,100
- location_name
  Type: string
  
  nom complet de l'emplacement du moteur de recherche
  champ obligatoire si vous ne spécifiez pas location_code ou location_coordinate
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ou location_coordinate
  vous pouvez recevoir la liste des emplacements disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/keywords_data/bing/locations
  exemple :
  London,England,United Kingdom

Réponses

200
Type: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
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_KeywordsDataBingAudienceEstimationLiveTaskInfo
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

currency
Type: string | null

nom de la devise

exemple : USDollar

est_audience_size
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

fourchette d'utilisateurs touchés estimés par mois

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

est_clicks
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

fourchette de clics estimés par mois

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

est_cost_per_event
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

indique le coût estimé par événement avec un résultat sous forme de fourchette

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

est_ctr
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

fourchette de taux de clics estimé

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

est_impressions
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

fourchette d'impressions estimées par mois

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

est_reach_audience_size
Type: integer | null Format: int64

nombre estimé d'utilisateurs par mois

est_reach_impressions
Type: integer | null Format: int64

impressions estimées par mois

est_spend
Type: object | null · Response36Afe1097B20_AudienceEstimationInfo

fourchette de dépenses estimées par mois

high
Type: number | null Format: double

indique la limite supérieure du résultat de la plage

low
Type: number | null Format: double

indique la limite inférieure du résultat de la plage

events_lost_to_bid
Type: integer | null Format: int64

indique le nombre d'événements perdus en raison d'une enchère d'entrée insuffisante

events_lost_to_budget
Type: integer | null

indique le nombre d'événements perdus en raison d'un budget d'entrée insuffisant

suggested_bid
Type: number | null

valeur d'enchère suggérée avec le ciblage actuel

suggested_budget
Type: number | null Format: double

valeur de budget quotidien suggérée avec le ciblage et l'enchère actuels

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

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_coordinate": "29.6821525,-82.4098881,100",
    "age": [
      "twenty_five_to_thirty_four",
      "eighteen_to_twenty_four",
      "unknown"
    ],
    "bid": 1,
    "daily_budget": 24,
    "gender": [
      "male"
    ],
    "industry": [
      "806303407",
      "806301758"
    ],
    "job_function": [
      "806298607"
    ]
  }
]'

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": [
        {
          "est_impressions": {
            "high": null,
            "low": null
          },
          "est_audience_size": {
            "high": null,
            "low": null
          },
          "est_clicks": {
            "high": null,
            "low": null
          },
          "est_spend": {
            "high": null,
            "low": null
          },
          "est_cost_per_event": {
            "high": null,
            "low": null
          },
          "est_ctr": {
            "high": null,
            "low": null
          },
          "suggested_bid": null,
          "suggested_budget": null,
          "events_lost_to_bid": null,
          "events_lost_to_budget": null,
          "est_reach_audience_size": null,
          "est_reach_impressions": null,
          "currency": null
        }
      ]
    }
  ]
}

Opération réussie

Configurer les tâches ‘Bing Ads Audience Estimation’ en temps réel

AuthentificationRequired

DataForSEO

Configurer les tâches ‘Bing Ads Audience Estimation’ en temps réel

Référence tarifaire