Vista general
API + MCPEl filtro regex tiene una funcionalidad limitada cuando se usa en esta solicitud y la sintaxis difiere de otras solicitudes. Espera un símbolo de asterisco (*) como comodín.
Parámetros de consulta
Una duración de tiempo de espera manual en segundos.
El número de resultados que se devolverán.
Una columna por la que ordenar los resultados. Consulta el Schema de respuesta para ver los identificadores de columna válidos, excepto volume_monthly, que no se admite en order_by para este endpoint.
La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores reconocidos por el parámetro select).
clicks: El promedio mensual de clics en los resultados de búsqueda que se realizan al buscar la palabra clave objetivo.
type: integer nullable
cpc: Coste por clic muestra el precio promedio que los anunciantes pagan por cada clic en anuncios en los resultados de búsqueda de pago para una palabra clave, en centavos de USD.
type: integer nullable
cps: Clics por búsqueda (o CPS) es la relación entre el número de Clics y el Volumen de búsqueda de la palabra clave. Muestra cuántos resultados de búsqueda diferentes reciben clics, de promedio, cuando las personas buscan la palabra clave objetivo en un país determinado.
type: float nullable
difficulty (10 units): Una estimación de lo difícil que es posicionarse entre los 10 primeros resultados orgánicos de búsqueda para una palabra clave en una escala de 100 puntos.
type: integer nullable
first_seen: La fecha en la que comprobamos por primera vez los resultados del motor de búsqueda para una palabra clave.
type: datetime nullable
global_volume (10 units): Cuántas veces al mes, de promedio, las personas buscan la palabra clave objetivo en todos los países de nuestra base de datos.
type: integer nullable
intents (10 units): Indica el propósito detrás de la consulta de búsqueda del usuario. Campos del objeto: informational, navigational, commercial, transactional, branded o local. Todos los campos son de tipo bool, con valores posibles true o false.
type: object nullable
keyword:
type: string
parent_topic: Tema principal determina si puedes posicionarte para tu palabra clave objetivo mientras apuntas a un tema más general en tu página. Para identificar el Tema principal, tomamos la página que ocupa la posición n.º 1 para tu palabra clave y encontramos la palabra clave responsable de enviar más tráfico a esa página.
type: string nullable
parent_volume (10 units): El Volumen de búsqueda del tema principal.
type: integer nullable
serp_domain_rating_top10_min: La palabra clave debe tener al menos una posición de ranking en los 10 primeros resultados con un DR de hasta este valor.
type: float nullable
serp_domain_rating_top5_min: La palabra clave debe tener al menos una posición de ranking en los 5 primeros resultados con un DR de hasta este valor.
type: float nullable
serp_features: Los resultados enriquecidos en una página de resultados del motor de búsqueda (SERP) que no son resultados orgánicos tradicionales.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"
serp_last_update: La fecha en la que comprobamos por última vez los resultados del motor de búsqueda para una palabra clave.
type: datetime nullable
traffic_potential (10 units): La suma del Tráfico orgánico que recibe la página que ocupa la posición n.º 1 para tu palabra clave objetivo desde todas las palabras clave para las que se posiciona.
type: integer nullable
volume (10 units): Una estimación del promedio de búsquedas mensuales de una palabra clave durante los últimos 12 meses de datos conocidos.
type: integer nullable
volume_desktop_pct: El porcentaje de búsquedas de una palabra clave realizadas en dispositivos de escritorio.
type: float nullable
volume_mobile_pct: El porcentaje de búsquedas de una palabra clave realizadas en dispositivos móviles.
type: float nullable
word_count:
type: integer
Una lista de columnas separadas por comas que se devolverán. Consulta el schema de respuesta para ver identificadores de columna válidos.
La fecha de finalización en formato AAAA-MM-DD para recuperar volúmenes de búsqueda mensuales históricos en el campo volume_monthly_history. Solo es obligatoria si se solicita volume_monthly_history.
La fecha de inicio en formato AAAA-MM-DD para recuperar volúmenes de búsqueda mensuales históricos en el campo volume_monthly_history. Solo es obligatoria si se solicita volume_monthly_history.
El alcance de la URL de destino que especificaste.
El objetivo de la búsqueda: un dominio o una URL.
Filtra las palabras clave según la posición de ranking del target especificado.
Un código de país de dos letras (ISO 3166-1 alpha-2).
[Obsoleto a partir del 5 de ago de 2024].
Una lista de palabras clave separadas por comas para mostrar las métricas.
El id de una lista de palabras clave existente para mostrar las métricas.
El formato de salida.
Respuestas
El promedio mensual de clics en los resultados de búsqueda que se realizan al buscar la palabra clave objetivo.
El coste por clic muestra el precio promedio que los anunciantes pagan por cada clic en un anuncio en los resultados de búsqueda de pago para una palabra clave, en centavos de USD.
Clics por búsqueda (o CPS) es la relación entre el número de Clics y el Volumen de búsqueda de la palabra clave. Muestra cuántos resultados de búsqueda diferentes reciben clics, de promedio, cuando las personas buscan la palabra clave de destino en un país determinado.
(10 unidades) Estimación de lo difícil que es posicionarse entre los 10 primeros resultados de búsqueda orgánica para una palabra clave en una escala de 100 puntos.
La fecha en la que comprobamos por primera vez los resultados de búsqueda para una palabra clave.
(10 units) Cuántas veces al mes, de promedio, las personas buscan la palabra clave objetivo en todos los países de nuestra base de datos.
(10 unidades) Indica la intención que hay detrás de la consulta de búsqueda del usuario. Campos del objeto: informational, navigational, commercial, transactional, branded o local. Todos los campos son de tipo bool, con valores posibles true o false.
El Tema principal determina si puedes posicionarte para tu palabra clave objetivo mientras te diriges a un tema más general en tu página. Para identificar el Tema principal, tomamos la página mejor posicionada para tu palabra clave y encontramos la palabra clave responsable de enviar la mayor parte del tráfico a esa página.
(10 unidades) El volumen de búsqueda del tema principal.
El porcentaje medio mensual de personas que hicieron clic tanto en resultados orgánicos como de pago al buscar la palabra clave objetivo.
El porcentaje medio mensual de personas que hicieron clic solo en resultados orgánicos al buscar la palabra clave objetivo.
El porcentaje medio mensual de personas que hicieron clic solo en resultados de pago al buscar la palabra clave objetivo.
Los resultados enriquecidos en una página de resultados de un motor de búsqueda (SERP) que no son resultados orgánicos tradicionales.
La fecha en la que comprobamos por última vez los resultados de búsqueda para una palabra clave.
(10 unidades) La suma del tráfico orgánico que recibe la página que ocupa el puesto #1 para tu palabra clave objetivo desde todas las palabras clave por las que se posiciona.
(10 unidades) Una estimación del número medio mensual de búsquedas de una palabra clave en los últimos 12 meses de datos disponibles.
El porcentaje de búsquedas de una palabra clave realizadas en dispositivos de escritorio.
El porcentaje de búsquedas de una palabra clave realizadas en dispositivos móviles.
(10 unidades) Una estimación del número de búsquedas de una palabra clave durante el último mes. Es posible que este campo no se incluya en el parámetro order_by
(2 unidades por mes histórico, con un mínimo de 50 unidades) Estimaciones históricas del Volumen de búsqueda mensual de una palabra clave para el periodo establecido por los parámetros volume_monthly_date_from y volume_monthly_date_to.