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

Resumen de palabras clave

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

Resumen de palabras clave

​

Todo lo que Labs sabe sobre una lista de keywords en una llamada: volumen, dificultad, intención, competencia y las funciones de SERP que activan. Devuelve se_type, location_code, language_code, items_count e items. Este endpoint no acepta parámetro de límite, pero se cobra por llamada y no por elemento, así que envía la lista completa de una vez. 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. Empieza aquí cuando tengas palabras clave; post_dataforseo_labs_google_keyword_ideas_live es el sitio al que ir cuando necesites más.

Referencia de precios

  • Medición: Coste de la respuesta notificado.
  • Estimación de referencia por solicitud: USD 0.0254.
  • Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo 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)[]
    • include_clickstream_data
      Tipo: boolean | null

      incluir o excluir datos de métricas basadas en clickstream en el resultado
      campo opcional
      si el parámetro se define como true, recibirás los campos clickstream_keyword_info, keyword_info_normalized_with_clickstream y keyword_info_normalized_with_bing en la respuesta
      valor predeterminado: false
      con este parámetro activado, se te cobrará el doble del precio base por la solicitud

      obtén más información sobre cómo se calculan las métricas basadas en clickstream en este artículo del Centro de ayuda

    • include_serp_info
      Tipo: boolean | null

      incluir datos de SERP para cada palabra clave
      campo opcional
      si se define como true, devolveremos un array serp_info que contiene datos de SERP (número de resultados de búsqueda, URL relevante y funciones de SERP) para cada palabra clave de la respuesta
      valor predeterminado: false

    • keywords
      Tipo: array string[]

      palabras clave
      campo obligatorio
      El número máximo de palabras clave que puedes especificar: 700
      El número máximo de caracteres para cada palabra clave: 80
      El número máximo de palabras para cada frase de palabra clave: 10
      las palabras clave especificadas se convertirán a formato minúsculo y los datos se proporcionarán en un array separado

      nota: si algunas de las palabras clave especificadas en este array se omiten en los resultados que recibes, significa que nuestra base de datos no contiene dichas palabras clave y no puede devolver datos sobre ellas
      no se te cobrará por las palabras clave omitidas en los resultados

      obtén 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
      campo obligatorio si no especificas language_name
      Nota: es obligatorio especificar language_name o language_code
      puedes obtener la lista de ubicaciones disponibles con su language_code haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      en

    • language_name
      Tipo: string

      nombre completo del idioma
      campo obligatorio si no especificas language_code
      Nota: es obligatorio especificar language_name o language_code
      puedes obtener la lista de ubicaciones disponibles con su language_name haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      English

    • location_code
      Tipo: integer

      código de ubicación
      campo obligatorio si no especificas location_name
      Nota: es obligatorio especificar location_name o location_code
      puedes obtener la lista de ubicaciones disponibles con su location_code haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      2840

    • location_name
      Tipo: string

      nombre completo de la ubicación
      campo obligatorio si no especificas location_code
      Nota: es obligatorio especificar location_name o location_code
      puedes obtener la lista de ubicaciones disponibles con su location_name haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      United Kingdom

    • 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_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
        • 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

          • items
            Tipo: array (object | null)[] | null

            contiene palabras clave y datos relacionados

            • avg_backlinks_info
              Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

              datos de backlinks para la palabra clave devuelta
              este objeto proporciona el número medio de backlinks, páginas de referencia y dominios, así como los valores de ranking medios entre los 10 sitios web principales que posicionan orgánicamente para la palabra clave

              • backlinks
                Tipo: number | null

                número medio de backlinks

              • dofollow
                Tipo: number | null

                número medio de enlaces dofollow

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizaron los datos de la palabra clave
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                Tipo: number | null

                posición media del dominio principal
                obtén más información sobre la métrica y su fórmula de cálculo en este artículo del centro de ayuda

              • rank
                Tipo: number | null

                rank medio
                obtén más información sobre la métrica y su fórmula de cálculo en este artículo del Centro de ayuda

              • referring_domains
                Tipo: number | null

                número medio de dominios de referencia

              • referring_main_domains
                Tipo: number | null

                número medio de dominios principales de referencia

              • referring_pages
                Tipo: number | null

                número medio de páginas de referencia

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

            • clickstream_keyword_info
              Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              datos de clickstream de la palabra clave devuelta
              para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true

              • age_distribution
                Tipo: object | null

                distribución de métricas basadas en clickstream por edad
                obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                • propertyName
                  Tipo: integer | null Formato: int64

                  Signed 64-bit integers (long type).

              • gender_distribution
                Tipo: object | null

                distribución de métricas estimadas basadas en clickstream por género
                obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                • propertyName
                  Tipo: integer | null Formato: int64

                  Signed 64-bit integers (long type).

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizaron los datos de la palabra clave
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-11-15 12:57:46 +00:00

              • 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 en los últimos doce meses), dirigidas a las ubicaciones geográficas especificadas

                • 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_volume
                Tipo: integer | null Formato: int64

                tasa media de volumen de búsqueda mensual
                representa el número (aproximado) de búsquedas de la idea de palabra clave dada en google.com

            • keyword
              Tipo: string | null

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

            • keyword_info
              Tipo: object | null · Response36Afe1097B20_KeywordInfo

              datos de palabras clave para la palabra clave devuelta

              • categories
                Tipo: array integer[] | null

                categorías de productos y servicios
                puedes descargar la lista completa de categorías posibles

              • competition
                Tipo: number | null

                competencia
                representa la cantidad relativa de competencia asociada con la palabra clave indicada. Este valor se basa en datos de Google Ads y puede estar entre 0 y 1 (inclusive)

              • competition_level
                Tipo: string | null

                nivel de competencia
                representa el nivel relativo de competencia asociado con la palabra clave indicada solo en el SERP de pago;
                valores posibles: LOW, MEDIUM, HIGH
                si se desconoce el nivel de competencia, 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
                representa el coste medio por clic (USD) pagado históricamente por la palabra clave

              • 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

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizaron los datos de la palabra clave
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-11-15 12:57:46 +00:00

              • 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 en los últimos doce meses), dirigidas a las ubicaciones geográficas especificadas

                • month
                  Tipo: integer | null

                  mes

                • search_volume
                  Tipo: integer | null

                  tasa media mensual de volumen de búsqueda

                • year
                  Tipo: integer | null

                  año

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

              • search_volume
                Tipo: integer | null Formato: int64

                tasa media de volumen de búsqueda mensual
                representa el número (aproximado) de búsquedas de la idea de palabra clave dada en google.com

              • search_volume_trend
                Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

                cambios en la tendencia del volumen de búsqueda
                representa el cambio porcentual del volumen de búsqueda respecto al periodo anterior

                • monthly
                  Tipo: integer | null

                  variación porcentual del volumen de búsqueda respecto al mes anterior

                • quarterly
                  Tipo: integer | null

                  variación porcentual del volumen de búsqueda respecto al trimestre anterior

                • yearly
                  Tipo: integer | null

                  variación porcentual del volumen de búsqueda respecto al año anterior

            • keyword_info_normalized_with_bing
              Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contiene el volumen de búsqueda de la palabra clave normalizado con el volumen de búsqueda de Bing

              • is_normalized
                Tipo: boolean | null

                la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizó el conjunto de datos en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00

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

                tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

                • 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_volume
                Tipo: integer | null

                tasa actual de volumen de búsqueda de una palabra clave

            • keyword_info_normalized_with_clickstream
              Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contiene el volumen de búsqueda de la palabra clave normalizado con datos de clickstream

              • is_normalized
                Tipo: boolean | null

                la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizó el conjunto de datos en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00

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

                tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

                • 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_volume
                Tipo: integer | null

                tasa actual de volumen de búsqueda de una palabra clave

            • keyword_properties
              Tipo: object | null · Response36Afe1097B20_KeywordProperties

              información adicional sobre la palabra clave

              • core_keyword
                Tipo: string | null

                palabra clave principal de un grupo
                contiene la palabra clave principal de un grupo determinada por el algoritmo de agrupación de sinónimos
                si el valor es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

              • detected_language
                Tipo: string | null

                idioma detectado de la palabra clave
                indica el idioma de la palabra clave según lo identifica nuestro sistema

              • is_another_language
                Tipo: boolean | null

                el idioma detectado de la palabra clave es distinto del idioma establecido
                si es true, el idioma establecido en la solicitud no coincide con el idioma determinado por nuestro sistema para una palabra clave

              • keyword_difficulty
                Tipo: integer | null

                dificultad de posicionarse entre los 10 primeros resultados orgánicos para una palabra clave
                indica la probabilidad de entrar en los 10 primeros resultados orgánicos para una palabra clave en una escala logarítmica de 0 a 100;
                se calcula analizando, entre otros parámetros, los perfiles de enlaces de las 10 primeras páginas del SERP;
                obtén más información sobre la métrica en esta guía del centro de ayuda

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

              • synonym_clustering_algorithm
                Tipo: string | null

                el algoritmo usado para identificar sinónimos
                valores posibles:
                keyword_metrics - indica el algoritmo basado en parámetros de keyword_info
                text_processing - indica el algoritmo basado en texto
                si el valor es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

              • words_count
                Tipo: integer | null Formato: int64

                número de palabras de la palabra clave
                indica cuántas palabras forman la palabra clave

            • language_code
              Tipo: string | null

              código de idioma en un array POST

            • location_code
              Tipo: integer | null

              código de ubicación en un array POST

            • se_type
              Tipo: string | null

              tipo de motor de búsqueda

            • search_intent_info
              Tipo: object | null · Response36Afe1097B20_SearchIntentInfo

              información de intención de búsqueda para la palabra clave devuelta
              obtén más información sobre la intención de búsqueda en este artículo del centro de ayuda

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

                intenciones de búsqueda complementarias
                valores posibles: informational, navigational, commercial, transactional

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizaron los datos de la palabra clave
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-11-15 12:57:46 +00:00

              • main_intent
                Tipo: string | null

                intención de búsqueda principal
                valores posibles: informational, navigational, commercial, transactional

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

            • search_partners
              Tipo: boolean | null

              indica datos para Google y sitios asociados
              si true, los resultados se devuelven para redes propias, operadas y sindicadas de Google y sitios asociados que alojan la búsqueda de Google;
              si false, los resultados se devuelven solo para sitios de búsqueda de Google

            • serp_info
              Tipo: object | null · Response36Afe1097B20_SerpInfo

              datos del SERP
              el valor será null si no estableces el campo include_serp_info en true en el array POST o si no hay datos de SERP para esta palabra clave en nuestra base de datos

              • check_url
                Tipo: string | null

                URL directa a los resultados del motor de búsqueda
                puedes usarla para asegurarte de que proporcionamos resultados precisos

              • last_updated_time
                Tipo: string | null

                fecha y hora en que se actualizaron los datos de la palabra clave
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                Tipo: string | null

                fecha y hora anterior a la más reciente en que se actualizaron los datos del SERP
                en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ejemplo:
                2019-10-15 12:57:46 +00:00

              • se_results_count
                Tipo: integer | null Formato: int64

                número de resultados de búsqueda para la palabra clave devuelta

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

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

                tipos de resultados de búsqueda en el SERP
                contiene los tipos de resultados de búsqueda (items) encontrados en el SERP
                tipos de elementos posibles:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                nota: los resultados reales solo se devolverán para los elementos organic, paid, featured_snippet y local_pack

          • items_count
            Tipo: integer | null Formato: int64

            el número de resultados devueltos en el array items

          • language_code
            Tipo: string | null

            código de idioma en un array POST

          • location_code
            Tipo: integer | null

            código de ubicación en un array POST

          • se_type
            Tipo: string | null

            tipo de motor de búsqueda

        • 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/dataforseo_labs/google/keyword_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "include_clickstream_data": true,
    "include_serp_info": true,
    "keywords": [
      "iphone"
    ]
  }
]'

{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "search_partners": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Keyword Overview