v0.2.0-beta

OpenAPI 3.1.0

Configurar tareas de ‘Google Ads Search Volume’ 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/google_ads/search_volume/live

Configurar tareas de ‘Google Ads Search Volume’ en vivo

Volumen de búsqueda de Google Ads para una lista de keywords. Devuelve keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc y monthly_searches, además de spell cuando Google corrigió el término. 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. Este es el número clásico de volumen de búsqueda; para la frecuencia con que las personas preguntan a un asistente, usa post_dataforseo_ai_keyword_volume_live. 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)[]
- date_from
  Tipo: string | null
  
  fecha de inicio del intervalo de tiempo
  campo opcional
  formato de fecha: "yyyy-mm-dd"
  valor mínimo: 4 años a partir de la fecha actual
  de forma predeterminada, los datos se devuelven para los últimos 12 meses;
  Nota: la fecha indicada no puede ser mayor que la especificada en date_to y/o la fecha de ayer;si el endpoint Status devuelve false en el campo actual_data, date_from puede establecerse en el mes anterior al pasado y anteriores;
  si el endpoint Status devuelve true en el campo actual_data, date_from puede establecerse en el mes pasado y anteriores
- date_to
  Tipo: string | null
  
  fecha de finalización del intervalo de tiempo
  campo opcional
  Nota: la fecha indicada no puede ser mayor que el mes pasado, Google Ads no devuelve datos del mes actual;
  si no especificas este campo, se usará la fecha de ayer de forma predeterminada
  formato de fecha: "yyyy-mm-dd"
  ejemplo:
  "2022-11-30"
- include_adult_keywords
  Tipo: boolean | null
  
  incluir palabras clave asociadas con contenido para adultos
  campo opcional
  si se define como true, las palabras clave para adultos se incluirán en la respuesta
  valor predeterminado: false
  ten en cuenta que la API puede no devolver datos para dichas palabras clave debido a las restricciones de Google Ads
- keywords
  Tipo: array string[]
  
  palabras clave
  campo obligatorio
  El número máximo de palabras clave que puedes especificar: 1000
  El número máximo de caracteres por palabra clave: 80
  El número máximo de palabras por frase de palabra clave: 10
  las palabras clave que especifiques se convertirán a minúsculas
  Nota n.º 1: Google Ads puede no devolver datos para determinados grupos de palabras clave;
  Nota n.º 2: Google Ads proporciona valores combinados de volumen de búsqueda para grupos de palabras clave similares
  para obtener el volumen de búsqueda de palabras clave similares, recomendamos enviar dichas palabras clave en solicitudes separadas;
  Nota n.º 3: Google Ads no permite el uso de determinados símbolos y caracteres (por ejemplo, símbolos UTF, emojis), por lo que no puedes usarlos al definir una tarea;
  para obtener más información sobre qué símbolos y caracteres se pueden usar, consulta este artículo
  
  más información sobre las reglas y limitaciones de los campos keyword y keywords en las API de DataForSEO en este artículo del Centro de ayuda
- language_code
  Tipo: string | null
  
  código de idioma del motor de búsqueda
  campo opcional
  puedes obtener la lista de idiomas disponibles del motor de búsqueda y su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  ejemplo:
  en
- language_name
  Tipo: string | null
  
  nombre completo del idioma del motor de búsqueda
  campo opcional
  puedes obtener la lista de idiomas disponibles del motor de búsqueda y su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  ejemplo:
  English
- location_code
  Tipo: integer | null
  
  código de ubicación del motor de búsqueda
  campo opcional
  si no indicas la ubicación, recibirás resultados mundiales, es decir, para todas las ubicaciones disponibles;
  si usas este campo, no necesitas especificar location_name ni location_coordinate;
  puedes obtener la lista de ubicaciones disponibles de los motores de búsqueda y su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  ejemplo:
  2840
- location_coordinate
  Tipo: string | null
  
  coordenadas GPS de una ubicación
  campo opcional
  si no indicas la ubicación, recibirás resultados mundiales, es decir, para todas las ubicaciones disponibles;
  si usas este campo, no necesitas especificar location_name ni location_code;
  el parámetro location_coordinate debe especificarse en el formato "latitude,longitude";
  los datos se proporcionarán para el país al que pertenecen las coordenadas especificadas;
  ejemplo:
  52.6178549,-155.352142
- location_name
  Tipo: string | null
  
  nombre completo de la ubicación del motor de búsqueda
  campo opcional
  si no indicas la ubicación, recibirás resultados mundiales, es decir, para todas las ubicaciones disponibles;
  si usas este campo, no necesitas especificar location_code ni location_coordinate
  puedes obtener la lista de ubicaciones disponibles del motor de búsqueda y su location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  ejemplo:
  London,England,United Kingdom
- search_partners
  Tipo: boolean | null
  
  incluir socios de búsqueda de Google
  campo opcional
  si especificas true, los resultados se entregarán para redes propias, operadas y sindicadas de Google y sitios asociados que alojan la búsqueda de Google;
  valor predeterminado: false - los resultados se devuelven para los sitios de búsqueda de Google
- sort_by
  Tipo: string | null
  
  parámetros de ordenación de los resultados
  campo opcional
  usa estos parámetros para ordenar los resultados por relevance, search_volume, competition_index, low_top_of_page_bid o high_top_of_page_bid en orden descendente
  valor predeterminado: relevance
- tag
  Tipo: string | null
  
  identificador de tarea definido por el usuario
  campo opcional
  el límite de caracteres es 255
  puedes usar este parámetro para identificar la tarea y relacionarla con el resultado
  encontrarás el valor de tag especificado en el array data de la respuesta

Respuestas

200
Tipo: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
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_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
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

competition
Tipo: string | null

competencia
representa la cantidad relativa de competencia asociada con la palabra clave indicada solo en el SERP de pago;
este valor se basa en datos de Google Ads y puede tomar los siguientes valores: HIGH, MEDIUM, LOW;
si no hay datos, el valor es null;
obtén más información sobre la métrica en este artículo del centro de ayuda

competition_index
Tipo: integer | null

competencia
representa la cantidad relativa de competencia asociada con la palabra clave indicada solo en el SERP de pago;
este valor se basa en datos de Google Ads y puede estar entre 0 y 100 (inclusive);
si no hay datos, el valor es null;
obtén más información sobre la métrica en este artículo del centro de ayuda

cpc
Tipo: number | null

coste por clic
indica el importe pagado (USD) por cada clic en el anuncio mostrado para una palabra clave determinada

high_top_of_page_bid
Tipo: number | null

puja máxima para que el anuncio se muestre en la parte superior de la primera página
indica el valor superior a aproximadamente el 80 % de las pujas más bajas por las que se mostraron anuncios (según las estadísticas de Google Ads para anunciantes);
el valor puede variar según la ubicación indicada en una solicitud POST

keyword
Tipo: string | null

palabra clave
la palabra clave se devuelve con %## decodificado (el carácter más '+' se decodificará como un espacio)

language_code
Tipo: string | null

código de idioma en un array del POST
si no hay datos, el valor es_nulln

location_code
Tipo: integer | null

código de ubicación en un array del POST
si no hay datos, el valor es_nulln

low_top_of_page_bid
Tipo: number | null

puja mínima para que el anuncio se muestre en la parte superior de la primera página
indica el valor superior a aproximadamente el 20 % de las pujas más bajas por las que se mostraron anuncios (según las estadísticas de Google Ads para anunciantes);
el valor puede variar según la ubicación indicada en una solicitud POST

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

búsquedas mensuales
representa el número (aproximado) de búsquedas de esta idea de palabra clave (según lo disponible para los últimos doce meses de forma predeterminada), dirigidas a las ubicaciones geográficas indicadas;
si no hay datos, el valor es null

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_partners
Tipo: boolean | null

indica si los datos de redes asociadas están incluidos en la respuesta

search_volume
Tipo: integer | null Formato: int64

tasa media mensual de volumen de búsqueda;
representa el número (aproximado) de búsquedas de la idea de palabra clave indicada en google.com o en google.com y sus socios, según la segmentación del usuario;
si no hay datos, el valor es null

spell
Tipo: string | null

ortografía correcta de la palabra clave
Nota:si la palabra clave del array POST parece estar mal escrita, se devolverán datos para la palabra clave escrita correctamente;
usamos la funcionalidad de la API de Google Ads para comprobar y validar la ortografía de las palabras clave, obtén más información en este enlace

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/google_ads/search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

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": [
        {
          "keyword": null,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Configurar tareas de ‘Google Ads Search Volume’ en vivo

AutenticaciónRequired

DataForSEO

Configurar tareas de ‘Google Ads Search Volume’ en vivo

Referencia de precios