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

Palabras clave posicionadas

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

DataForSEO

​

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

Palabras clave posicionadas

​

Los términos de búsqueda de Amazon por los que posiciona un producto. Pagina con limit, offset y offset_token; usa el token después de las primeras páginas. 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 índice propio de Amazon de Labs, así que pagina y responde de inmediato, a diferencia de seo-merchant, que encola un scraping en vivo de la tienda.

Referencia de precios

  • Medición: Coste de la respuesta notificado.
  • Estimación de referencia por solicitud: USD 0.1356.
  • 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)[]
    • asin
      Tipo: string

      ID del producto
      campo obligatorio
      identificador único de producto (ASIN) en Amazon;
      puedes obtener el parámetro asin haciendo una solicitud independiente al endpoint Amazon Products

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

      array de parámetros de filtrado de resultados
      campo opcional
      puedes añadir varios filtros a la vez (máximo 8 filtros)
      debes definir un operador lógico and, or entre las condiciones
      se admiten los siguientes operadores:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, match, not_match
      puedes usar el operador % con like y not_like para coincidir con cualquier cadena de cero o más caracteres
      ejemplo:
      ["keyword_data.keyword_info.search_volume","in",[100,1000]];

      para obtener más información sobre los filtros, consulta Dataforseo Labs - Filters o esta guía del Centro de ayuda

      Objeto vacío
    • ignore_synonyms
      Tipo: boolean | null

      ignorar palabras clave muy similares
      campo opcional
      si se define como true, solo se devolverán las palabras clave principales y se excluirán todas las palabras clave muy similares;
      valor predeterminado: false

    • language_code
      Tipo: string | null

      código de idioma
      campo obligatorio si no especificas language_name
      puedes obtener la lista de idiomas disponibles con su language_code haciendo una solicitud independiente a
      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
      puedes obtener la lista de idiomas disponibles con su language_name haciendo una solicitud independiente a
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      English

    • limit
      Tipo: integer | null

      el número máximo de productos en el array de resultados
      campo opcional
      valor predeterminado: 100;
      valor máximo: 1000

    • location_code
      Tipo: integer

      código de ubicación
      campo obligatorio si no especificas location_name
      puedes obtener la lista de ubicaciones disponibles con su location_code haciendo una solicitud independiente a
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
      Nota: este endpoint actualmente solo admite las ubicaciones de Estados Unidos, Egipto, Arabia Saudita y los Emiratos Árabes Unidos;
      ejemplo:
      2840

    • location_name
      Tipo: string

      nombre completo de la ubicación
      campo obligatorio si no especificas location_code
      puedes obtener la lista de ubicaciones disponibles con su location_name haciendo una solicitud independiente a
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
      Nota: este endpoint actualmente solo admite las ubicaciones de Estados Unidos, Egipto, Arabia Saudita y los Emiratos Árabes Unidos;
      ejemplo:
      United States

    • offset
      Tipo: integer | null

      desplazamiento en el array de resultados de las palabras clave devueltas
      campo opcional
      valor predeterminado: 0
      si especificas el valor 10, se omitirán las diez primeras palabras clave del array de resultados y los datos se proporcionarán para las palabras clave siguientes

    • order_by
      Tipo: array string[] | null

      reglas de ordenación de los resultados
      campo opcional
      puedes usar los mismos valores que en el array filters para ordenar los resultados
      tipos de ordenación posibles:
      asc - los resultados se ordenarán en orden ascendente
      desc - los resultados se ordenarán en orden descendente
      debes usar una coma para definir un parámetro de ordenación
      ejemplo:
      ["keyword_data.keyword_info.competition,desc"]
      regla predeterminada:
      ["ranked_serp_element.serp_item.rank_group,asc"]
      ten en cuenta que puedes definir como máximo tres reglas de ordenación en una sola solicitud
      debes usar una coma para separar varias reglas de ordenación
      ejemplo:
      ["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"]

    • 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_DataforseoLabsAmazonRankedKeywordsLiveResponseInfo
    • 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_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo
        • 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

          • asin
            Tipo: string | null

            ASIN en un array del POST

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

            contiene competidores de productos de Amazon detectados y datos relacionados

            • keyword_data
              Tipo: object | null · Response36Afe1097B20_KeywordDataInfo

              datos de palabras clave para la palabra clave devuelta

              • avg_backlinks_info
                Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

                datos de backlinks de la palabra clave devuelta
                este objeto proporciona el número medio de backlinks, páginas de referencia y dominios, así como los valores medios de clasificación entre las 10 páginas principales que se posicionan de forma orgánica 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

                idea de palabra clave devuelta

              • keyword_info
                Tipo: object | null · Response36Afe1097B20_KeywordInfo

                datos de palabra clave de la idea de 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 de 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

              • 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

            • ranked_serp_element
              Tipo: object | null · Response36Afe1097B20_AmazonRankedSerpElement

              contiene datos sobre el elemento SERP del producto encontrado para la keyword devuelta

              • check_url
                Tipo: string | null

                URL directa a los resultados de Amazon
                puedes usarla para asegurarte de que proporcionamos resultados precisos

              • last_updated_time
                Tipo: string | null

                fecha y hora de la actualización de los datos de palabras 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

                anterior a la actualización más reciente de los datos de la SERP
                en el formato ISO 8601: “YYYY-MM-DDThh:mm:ss.sssssssZ”
                ejemplo:
                2020-09-12T00:07:43.0733218Z

              • se_results_count
                Tipo: integer | null Formato: int64

                número total de resultados en la SERP de Amazon

              • se_type
                Tipo: string | null

                tipo de motor de búsqueda

              • serp_item
                Tipo: object | null · Response36Afe1097B20_AmazonInfo

                contiene datos sobre el elemento del SERP
                la lista de elementos del SERP compatibles se encuentra a continuación

                • asin
                  Tipo: string | null

                  ASIN en un array del POST

                • bought_past_month
                  Tipo: integer | null

                  Integer numbers.

                • currency
                  Tipo: string | null

                  moneda en formato ISO
                  ejemplo:
                  USD

                • delivery_info
                  Tipo: object | null · Response36Afe1097B20_AmazonDeliveryInfo

                  información de entrega
                  información de entrega, incluidos los intervalos de fechas de entrega gratuita y rápida

                  • delivery_date_from
                    Tipo: string | null

                    la fecha más próxima en la que el producto puede enviarse

                  • delivery_date_to
                    Tipo: string | null

                    la fecha más tardía en la que el producto puede entregarse

                  • delivery_message
                    Tipo: string | null

                    mensaje que acompaña a la información de entrega tal como la publica el vendedor

                  • delivery_price
                    Tipo: object | null · Response36Afe1097B20_PriceInfo

                    precio de la entrega precio de la entrega según la ubicación que especificaste en la solicitud POST; si hay entrega gratuita disponible, el valor es null

                    • currency
                      Tipo: string | null

                      moneda del precio indicado código ISO de la moneda aplicada al precio

                    • current
                      Tipo: number | null Formato: double

                      precio actual indica el precio actual del producto o servicio destacado en el resultado

                    • displayed_price
                      Tipo: string | null

                      cadena de precio del resultado cadena de precio sin formato tal como se proporciona en el resultado

                    • is_price_range
                      Tipo: boolean | null

                      el precio se proporciona como un intervalo indica si un precio se proporciona como un intervalo

                    • max_value
                      Tipo: number | null Formato: double

                      el precio máximo el precio máximo del producto o servicio tal como se indica en el resultado

                    • regular
                      Tipo: number | null Formato: double

                      precio habitual indica el precio habitual del producto o servicio sin descuentos aplicados

                  • fastest_delivery_date_from
                    Tipo: string | null

                    la fecha más próxima en la que el producto puede entregarse con una opción de entrega rápida

                  • fastest_delivery_date_to
                    Tipo: string | null

                    la fecha más tardía en la que el producto puede entregarse con una opción de entrega rápida

                • domain
                  Tipo: string | null

                  dominio de Amazon

                • image_url
                  Tipo: string | null

                  URL de la imagen del producto destacada en los resultados

                • is_amazon_choice
                  Tipo: boolean | null

                  etiqueta "Amazon's choice"
                  si el valor es true, el producto lleva la etiqueta "Amazon's choice"

                • is_best_seller
                  Tipo: boolean | null

                  etiqueta "Best Seller"
                  si el valor es true, el producto lleva la etiqueta "Best Seller"

                • position
                  Tipo: string | null

                  la alineación del elemento en la SERP de Amazon
                  puede tomar los siguientes valores:
                  left, right

                • price_from
                  Tipo: number | null

                  el precio habitual de un producto
                  ejemplo:
                  49.98

                • price_to
                  Tipo: number | null

                  el límite superior del intervalo de precio del producto
                  ejemplo:
                  384.99

                • rank_absolute
                  Tipo: integer | null

                  posición absoluta en la SERP de Amazon
                  posición absoluta entre todos los elementos de la SERP

                • rank_group
                  Tipo: integer | null

                  posición dentro de un grupo de elementos con valores de type idénticos
                  las posiciones de los elementos con valores de type diferentes se omiten de rank_group

                • rating
                  Tipo: object | null · Response36Afe1097B20_RatingInfo

                  la valoración del elemento
                  la tasa de popularidad basada en las reseñas y mostrada en la SERP

                  • rating_max
                    Tipo: integer | null

                    el valor máximo para un rating_type

                  • rating_type
                    Tipo: string | null

                    el tipo de valoración aquí puedes encontrar los siguientes elementos: Max5, Percents, CustomMax

                  • value
                    Tipo: number | null Formato: float

                    el valor de la valoración

                  • votes_count
                    Tipo: integer | null Formato: int64

                    la cantidad de feedback

                • se_type
                  Tipo: string | null

                  tipo de motor de búsqueda

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

                  detalles de la oferta especial
                  contiene los detalles de la oferta especial, incluidos los descuentos por cupón y de Subscribe & Save

                • title
                  Tipo: string | null

                  título del producto

                • type
                  Tipo: string | null

                  tipo de elemento

                • url
                  Tipo: string | null

                  URL de la página del producto

                • xpath
                  Tipo: string | null

                  el XPath del elemento

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

                URL directa a los resultados de Amazon
                contiene los tipos de todos los resultados de búsqueda (items) encontrados en la SERP devuelta;
                tipos de elementos posibles:
                amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches

            • se_type
              Tipo: string | null

              tipo de motor de búsqueda

          • 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 del POST
            si no hay datos, el valor es null

          • location_code
            Tipo: integer | null

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

          • se_type
            Tipo: string | null

            tipo de motor de búsqueda

          • total_count
            Tipo: integer | null Formato: int64

            cantidad total de resultados de nuestra base de datos relevantes para tu solicitud

        • 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/amazon/ranked_keywords/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/ranked_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "asin": "B00R92CL5E",
    "location_code": 2840,
    "language_code": "en"
  }
]'
{
  "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,
          "asin": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "ranked_serp_element": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Ranked Keywords