Felo API PlatformFelo API Platform
Todos los endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Búsqueda de anuncios de Google Ads avanzada en vivo

Servidor:https://openapi.felo.ai
Bibliotecas cliente

DataForSEO

​

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

Búsqueda de anuncios de Google Ads avanzada en vivo

​

Devuelve los anuncios que se muestran para una palabra clave en Google, de forma síncrona. Devuelve keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced es la opción predeterminada; usa regular cuando solo importe la lista clasificada y html solo para comprobar qué descartó el analizador. 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.

Referencia de precios

  • Medición: Costo de respuesta reportado.
  • Estimación de referencia por solicitud: USD 0.02.
  • 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[]
      • advertiser_ids
        Tipo: array string[]
        obligatorio

        Identificadores de anunciantes; obligatorio si no se especifica target

      • location_code
        Tipo: integer

        Código de ubicación del motor de búsqueda

      • location_coordinate
        Tipo: string

        Coordenadas GPS de una ubicación

      • location_name
        Tipo: string

        Nombre completo de la ubicación del motor de búsqueda

      • target
        Tipo: string

        Nombre de dominio asociado a una cuenta de anunciante; obligatorio si no se especifica advertiser_ids

Respuestas
  • 200
    Tipo: object

    Respuesta correcta

    • cost
      Tipo: number

      Costo total de las tareas, USD

    • status_code
      Tipo: integer

      Código de estado general

    • status_message
      Tipo: string

      Mensaje informativo general

    • tasks
      Tipo: array string[]

      Array de tareas

    • tasks[].result
      Tipo: array string[]

      Array de resultados de SERP en vivo

    • time
      Tipo: string

      Tiempo de ejecución, segundos

    • version
      Tipo: string

      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
Request Example for post/v1/beta/dataforseo/serp/google/ads_search/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {}
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks": [
    "string"
  ],
  "tasks[].result": [
    "string"
  ]
}
Live Google Ads Search Advanced