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

Configurar tareas de ‘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

Configurar tareas de ‘Search Volume’ en vivo

​

Volumen de búsqueda de Bing para una lista de keywords. Devuelve keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories y monthly_searches: observa categories, que el equivalente de Google no devuelve, y la ausencia de competition_index. 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. El equivalente en Google es post_dataforseo_keywords_gads_search_volume_live; ejecuta ambos cuando el público no sea solo de Google. 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
      valor mínimo: 24 meses desde la fecha actual;
      si no especificas este campo, los datos se proporcionarán para los últimos 12 meses;
      valor mínimo: dos años atrás desde la fecha actual;
      si el endpoint Status devuelve false en el campo actual_data, date_from se puede establecer en el mes antepasado y los anteriores;
      si el endpoint Status devuelve true en el campo actual_data, date_from se puede establecer en el último mes y los anteriores;
      formato de fecha: "yyyy-mm-dd"
      ejemplo:
      "2020-01-01"Nota: no recomendamos usar un intervalo de tiempo personalizado para fechas del último año

    • date_to
      Tipo: string | null

      fecha de fin del intervalo de tiempo
      campo opcional
      si no especificas este campo, los datos se proporcionarán para los últimos 12 meses;
      valor mínimo: dos años atrás desde la fecha actual;
      valor máximo: un mes a partir de la fecha actual;
      nota: no recomendamos usar un intervalo de tiempo personalizado para fechas del último año;
      formato de fecha: "yyyy-mm-dd"
      ejemplo:
      "2020-03-15"Nota: no recomendamos usar un intervalo de tiempo personalizado para fechas del último año

    • device
      Tipo: string | null

      tipo de dispositivo
      campo opcional
      especifica este campo para obtener los datos de un tipo de dispositivo concreto;
      valores posibles: all, mobile, desktop, tablet
      valor predeterminado: all

    • 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 para cada palabra clave: 100
      las palabras clave especificadas se convertirán a minúsculas y los datos se proporcionarán en un array independiente. 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

      código de idioma del motor de búsqueda
      campo obligatorio si no especificas language_name
      si usas este campo, no necesitas especificar language_name
      idiomas admitidos:
      en, fr, de

    • language_name
      Tipo: string

      nombre completo del idioma del motor de búsqueda
      campo obligatorio si no especificas language_code
      si usas este campo, no necesitas especificar language_code
      idiomas admitidos:
      English, French, German

    • 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"
      los datos se proporcionarán para el país al que pertenecen las coordenadas especificadas
      ejemplo:
      52.6178549,-155.352142

    • 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

    • search_partners
      Tipo: boolean | null

      tipo de socios de búsqueda de Bing
      campo opcional
      si especificas true, los resultados se entregarán para redes propias, operadas y sindicadas de Bing, Yahoo, AOL y sitios asociados que alojan las búsquedas de Bing, AOL y Yahoo.
      valor predeterminado: false - los resultados se devuelven para las redes de búsqueda de Bing, AOL y Yahoo

    • sort_by
      Tipo: string | null

      parámetros de ordenación de los resultados
      campo opcional
      usa estos parámetros para ordenar los resultados por search_volume, cpc, competition o relevance 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 objeto data de la respuesta

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeLiveResponseInfo
    • 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_KeywordsDataBingSearchVolumeLiveTaskInfo
        • 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

          • categories
            Tipo: array (string | null)[] | null

            categorías de productos y servicios
            nuestra API no devuelve categorías para este endpoint: el parámetro siempre será igual a null

          • competition
            Tipo: number | 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 Bing Ads.
            Valores posibles: 0.1, 0.5,0.90.1 - competencia baja,
            0.5 - competencia media,
            0.9 - competencia alta;
            si no hay datos, el valor es null

          • cpc
            Tipo: number | null

            coste por clic
            representa el coste medio por clic (USD) pagado históricamente por la palabra clave.
            si no hay datos, el valor es null

          • device
            Tipo: string | null

            tipo de dispositivo en un array POST
            si no hay datos, el valor es null

          • keyword
            Tipo: string | null

            palabra clave en un array POST

          • 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

          • 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), 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 el motor de búsqueda Bing, según la segmentación del usuario;
            el volumen de búsqueda se redondea a las decenas más cercanas;
            si no hay datos, el valor es null

        • 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
Request Example for post/v1/beta/dataforseo/keywords_data/bing/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Setting Live ‘Search Volume’ Tasks