Consultas de Elasticsearch

Hay limitaciones ligeramente diferentes en las API de consulta dependiendo de qué nivel de servicio tengas (WordPress.com VIP, Jetpack Pro o Jetpack Entradas Relacionadas). Dependiendo del nivel de servicio, diferentes características del Elasticsearch Query DSL están disponibles. Actualmente hay dos API disponibles:

API de Búsqueda de Publicaciones (VIP y Jetpack Pro).
- Principalmente es un envoltorio alrededor de la API Elasticsearch /_search.
- La respuesta se ve ligeramente diferente debido a la exclusión de algunos campos y algunas razones históricas.
- Soporta un subconjunto de los principales parámetros de consulta. Consulta documentación de la API.
API de Entradas Relacionadas (Gratuito)
- Acepta Filtros de Elasticsearch para modificar los resultados. Muchos ejemplos comunes aquí.
- Devuelve el post_id y blog_id de cualquier resultado.

Consultas Permitidas (& Filtros)

Para evitar problemas de rendimiento y asegurar la compatibilidad hacia atrás, solo permitimos un subconjunto del Elasticsearch Query DSL.

Elasticsearch se ha alejado de separar explícitamente consultas y filtros, así que nosotros tampoco lo hacemos.

Consultas Comunes:

bool
match
multi match
function score
- random_score no es soportado
match all
range
term
terms

Consultas Exóticas:

Consultas Obsoletas (Se eliminarán en el futuro):

and filter (obsoleto, usa bool)
not filter (obsoleto, usa bool)
or filter (obsoleto, usa bool)
filtered query (obsoleto, usa bool)

Agregaciones Permitidas

Para evitar problemas de rendimiento y asegurar la compatibilidad hacia atrás, solo permitimos un subconjunto del Elasticsearch Aggregations DSL. Actualmente no permitimos ninguna agregación de pipeline.

No se permiten agregaciones en ningún campo de contenido analizado (por ejemplo, «content», «title», «tag.name.en»).

Agregaciones Métricas

Agregaciones por Cubos

Campo Size

El tamaño máximo permitido size depende de tu nivel de servicio:

Plan Profesional de Jetpack: 0-100
WordPress.com VIP (con un índice dedicado): 0-1000
Plan Gratuito de Jetpack (API de Entradas Relacionadas): 1-15

Campo From

El tamaño máximo permitido from depende de tu nivel de servicio:

Plan Profesional de Jetpack: 0-1000
WordPress.com VIP (con un índice dedicado): 0-9000
Plan Gratuito de Jetpack (API de Entradas Relacionadas): 0-50

Campos

Aunque es posible devolver campos del índice, esto se desaconseja encarecidamente para consultas en producción. El índice ha sido optimizado para devolver de manera eficiente y rápida post_id y blog_id. Devolver otros campos es posible, pero ralentizará los resultados de búsqueda.

La otra razón para confiar en post_id y luego obtener los datos finales de la base de datos es que el índice de Elasticsearch es solo un espejo de tus datos. Está en caché, puede estar retrasado o puede estar ligeramente desincronizado con tu base de datos. Cualquiera de estas situaciones podría resultar en servir contenido obsoleto si confías en ello.

Ordenación

La ordenación básica en cualquier campo está permitida. No permitimos ningún scripting.

Sugerencias Permitidas (Experimental)

Las sugerencias son actualmente experimentales ya que aún no tenemos bibliotecas que las utilicen en producción. Hay un problema abierto sobre cómo integrarlo. Solo se admiten sugerencias de términos y frases. El soporte exacto puede cambiar.

Reevaluación Permitida (Experimental)

Actualmente soportamos la reevaluación de consultas para algunas características experimentales. Probablemente no deberías usarlo.

Facetas (Obsoletas)

Las facetas están obsoletas y serán eliminadas. No las uses. Usa agregaciones en su lugar. Aún tenemos algunos clientes VIP que las utilizan, por eso la API las acepta, pero probablemente no funcionen para ti.

* Elasticsearch es una marca registrada de Elasticsearch BV, registrada en EE. UU. y en otros países.

Última actualización: mayo 19, 2026