v0.2.0-beta

OpenAPI 3.1.0

Configurar tareas de ‘Bing Ads Audience Estimation’ en vivo

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaciones

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

Configurar tareas de ‘Bing Ads Audience Estimation’ en vivo

Estima la audiencia de Bing Ads alcanzable con un bid y un daily_budget determinados, acotada por location_code, age, sector y función laboral. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. Los valores de sector y función laboral vienen de get_dataforseo_keywords_bing_audience_industries y get_dataforseo_keywords_bing_audience_job_functions, ambos gratuitos, y merece la pena leerlos ambos antes de componer una solicitud. Las variantes de envío y recuperación de este endpoint hacen el mismo trabajo de forma asíncrona, al mismo precio, para lotes demasiado grandes para esperar.

Referencia de precios

Medición: Costo de respuesta reportado.
Estimación de referencia por solicitud: USD 0.09.
Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Cuerpo

application/json

Tipo: array (object | null)[]
- age
  Tipo: array string[] | null
  
  selección de rangos de edad para el direccionamiento
  valores posibles: 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
  Tipo: number | null
  
  valor deseado de la configuración de puja en USD
  valor máximo: 1000
- daily_budget
  Tipo: number | null
  
  valor del presupuesto diario de la campaña en USD
  valor máximo: 10000
- gender
  Tipo: array string[] | null
  
  género para el direccionamiento
  valores posibles: male, female, unknown
- industry
  Tipo: array string[] | null
  
  sector del direccionamiento de perfiles de LinkedIn
  
  si usas este campo, puedes recibir la lista de nombres de sectores disponibles con industry_id haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  ejemplo: 806301758
- job_function
  Tipo: array string[] | null
  
  función profesional del direccionamiento de perfiles de LinkedIn
  
  si usas este campo, puedes recibir la lista de nombres de funciones profesionales disponibles con job_function_id haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  ejemplo: 806300451
- location_code
  Tipo: integer
  
  código de ubicación del motor de búsqueda
  campo obligatorio si no especificas location_name o location_coordinate
  si usas este campo, no necesitas especificar location_name o location_coordinate
  puedes recibir la lista de ubicaciones disponibles de los motores de búsqueda con su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/bing/locations
  ejemplo:
  2840
- location_coordinate
  Tipo: string
  
  coordenadas GPS de una ubicación
  campo obligatorio si no especificas location_name o location_code
  si usas este campo, no necesitas especificar location_name o location_code
  el parámetro location_coordinate debe especificarse en el formato "latitud,longitud,radio (en km)"
  los datos se proporcionarán para el país al que pertenecen las coordenadas especificadas
  ejemplo:
  29.6821525,-82.4098881,100
- location_name
  Tipo: string
  
  nombre completo de la ubicación del motor de búsqueda
  campo obligatorio si no especificas location_code o location_coordinate
  si usas este campo, no necesitas especificar location_code o location_coordinate
  puedes recibir la lista de ubicaciones disponibles del motor de búsqueda con su location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/bing/locations
  ejemplo:
  London,England,United Kingdom

Respuestas

200
Tipo: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

tasks
Tipo: array (object | null)[] | null

array de tareas

Tipo: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

path
Tipo: array (string | null)[] | null

ruta de la URL

result
Tipo: array (object | null)[] | null

array de resultados

currency
Tipo: string | null

nombre de la moneda

ejemplo: USDollar

est_audience_size
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

intervalo de usuarios alcanzados estimados al mes

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

est_clicks
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

intervalo de clics estimados al mes

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

est_cost_per_event
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

indica el coste estimado por evento con resultado de intervalo

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

est_ctr
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

intervalo de tasa de clics estimada

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

est_impressions
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

intervalo de impresiones estimadas al mes

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

est_reach_audience_size
Tipo: integer | null Formato: int64

número estimado de usuarios al mes

est_reach_impressions
Tipo: integer | null Formato: int64

impresiones estimadas al mes

est_spend
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

intervalo de gasto estimado al mes

high
Tipo: number | null Formato: double

indica el límite superior del resultado del intervalo

low
Tipo: number | null Formato: double

indica el límite inferior del resultado del intervalo

events_lost_to_bid
Tipo: integer | null Formato: int64

indica el recuento de eventos perdidos por una puja de entrada insuficiente

events_lost_to_budget
Tipo: integer | null

indica el recuento de eventos perdidos por un presupuesto de entrada insuficiente

suggested_bid
Tipo: number | null

valor de puja sugerido con la segmentación actual

suggested_budget
Tipo: number | null Formato: double

valor de presupuesto diario sugerido con la segmentación y la puja actuales

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

la versión actual de la API
application/json
400

No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
401

Se requiere una clave de API de Felo válida.
402

La solicitud no puede continuar porque no se cumple un requisito de facturación.
403

La cuenta no tiene permiso para realizar esta operación.
429

Se ha alcanzado un límite de solicitudes o de gasto.
502

El servicio no pudo completar la solicitud.
503

La API o el servicio de facturación no están disponibles temporalmente.
504

El servicio agotó el tiempo de espera al procesar la solicitud.
default

Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

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"
    ]
  }
]'

Mostrar esquema

{
  "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
        }
      ]
    }
  ]
}

Operación correcta

Configurar tareas de ‘Bing Ads Audience Estimation’ en vivo

AutenticaciónRequired

DataForSEO

Configurar tareas de ‘Bing Ads Audience Estimation’ en vivo

Referencia de precios