v0.2.0-beta

OpenAPI 3.1.0

Configurar tarefas de ‘Bing Ads Audience Estimation’ em tempo real

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 Operações

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

Configurar tarefas de ‘Bing Ads Audience Estimation’ em tempo real

Estima a audiência do Bing Ads alcançável com um determinado bid e daily_budget, restrita por location_code, age, setor e função profissional. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Os valores de setor e função profissional vêm de get_dataforseo_keywords_bing_audience_industries e get_dataforseo_keywords_bing_audience_job_functions — ambos gratuitos, e vale a pena ler os dois antes de montar uma requisição. As variantes de envio e recuperação deste endpoint fazem o mesmo trabalho de forma assíncrona, pelo mesmo preço, para lotes grandes demais para aguardar.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.09.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Corpo

application/json

Tipo: array (object | null)[]
- age
  Tipo: array string[] | null
  
  seleção de faixas etárias para direcionamento
  valores possíveis: 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 desejado da configuração de lance em USD
  valor máximo: 1000
- daily_budget
  Tipo: number | null
  
  valor do orçamento diário da campanha em USD
  valor máximo: 10000
- gender
  Tipo: array string[] | null
  
  gênero para direcionamento
  valores possíveis: male, female, unknown
- industry
  Tipo: array string[] | null
  
  setor do direcionamento de perfis do LinkedIn
  
  se você usar este campo, poderá receber a lista de nomes de setores disponíveis com industry_id fazendo uma requisição separada para https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  exemplo: 806301758
- job_function
  Tipo: array string[] | null
  
  função profissional do direcionamento de perfis do LinkedIn
  
  se você usar este campo, poderá receber a lista de nomes de funções profissionais disponíveis com job_function_id fazendo uma requisição separada para https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  exemplo: 806300451
- location_code
  Tipo: integer
  
  código do local do mecanismo de busca
  campo obrigatório se você não especificar location_name ou location_coordinate
  se você usar este campo, não precisa especificar location_name ou location_coordinate
  você pode receber a lista de locais disponíveis dos mecanismos de busca com seu location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/keywords_data/bing/locations
  exemplo:
  2840
- location_coordinate
  Tipo: string
  
  coordenadas GPS de um local
  campo obrigatório se você não especificar location_name ou location_code
  se você usar este campo, não precisa especificar location_name ou location_code
  o parâmetro location_coordinate deve ser especificado no formato "latitude,longitude,raio (em km)"
  os dados serão fornecidos para o país ao qual as coordenadas especificadas pertencem
  exemplo:
  29.6821525,-82.4098881,100
- location_name
  Tipo: string
  
  nome completo do local do mecanismo de busca
  campo obrigatório se você não especificar location_code ou location_coordinate
  se você usar este campo, não precisa especificar location_code ou location_coordinate
  você pode receber a lista de locais disponíveis do mecanismo de busca com seu location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/keywords_data/bing/locations
  exemplo:
  London,England,United Kingdom

Respostas

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

custo total das tarefas, USD

status_code
Tipo: integer | null

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

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

array de tarefas

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

custo total das tarefas, USD

data
Tipo: object | null

contém os mesmos parâmetros que você especificou na requisição POST

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

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

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

caminho da URL

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

array de resultados

currency
Tipo: string | null

nome da moeda

exemplo: USDollar

est_audience_size
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

faixa de usuários alcançados estimados por mês

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

est_clicks
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

faixa de cliques estimados por mês

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

est_cost_per_event
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

indica o custo estimado por evento com resultado em faixa

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

est_ctr
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

faixa de taxa de cliques estimada

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

est_impressions
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

faixa de impressões estimadas por mês

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

est_reach_audience_size
Tipo: integer | null Formato: int64

número estimado de usuários por mês

est_reach_impressions
Tipo: integer | null Formato: int64

impressões estimadas por mês

est_spend
Tipo: object | null · Response36Afe1097B20_AudienceEstimationInfo

faixa de gasto estimado por mês

high
Tipo: number | null Formato: double

indica o limite superior do resultado do intervalo

low
Tipo: number | null Formato: double

indica o limite inferior do resultado do intervalo

events_lost_to_bid
Tipo: integer | null Formato: int64

indica a contagem de eventos perdidos por lance de entrada insuficiente

events_lost_to_budget
Tipo: integer | null

indica a contagem de eventos perdidos por orçamento de entrada insuficiente

suggested_bid
Tipo: number | null

valor de lance sugerido com o direcionamento atual

suggested_budget
Tipo: number | null Formato: double

valor de orçamento diário sugerido com o direcionamento e o lance atuais

result_count
Tipo: integer | null Formato: int64

número de elementos no array de resultados

status_code
Tipo: integer | null

código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

time
Tipo: string | null

tempo de execução, segundos

tasks_count
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas

tasks_error
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas retornadas com erro

time
Tipo: string | null

tempo total de execução, em segundos

version
Tipo: string | null

a versão atual da API
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

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 Schema

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

Operação bem-sucedida

Configurar tarefas de ‘Bing Ads Audience Estimation’ em tempo real

AutenticaçãoRequired

DataForSEO

Configurar tarefas de ‘Bing Ads Audience Estimation’ em tempo real

Referência de preços