Inicio rápido de la API de Search

Ejecuta búsquedas neuronales o por palabras clave en tu Biblioteca desde la línea de comandos o cualquier cliente HTTP.

21 may 2026

La API de Search da acceso programático al mismo motor de recuperación que impulsa Search y Chat de Vulgate. Puedes ejecutar búsquedas neuronales (basadas en significado) y por palabras clave (coincidencia literal), con filtros opcionales para autor, año de publicación, ISBN e ID de documento.

La referencia completa está en /developers/search/overview. Esta guía cubre los patrones más comunes.

Búsqueda neuronal

Encuentra pasajes cuyo significado coincide con una consulta:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=concilios de la iglesia primitiva sobre autoridad cívica" \
  --data-urlencode "mode=neural" \
  --data-urlencode "per_page=5"

Respuesta (truncada):

{
  "data": [
    {
      "id": "part-abc123",
      "document_id": "doc-xyz789",
      "index": "urn:vulgate:doc-xyz789:42",
      "content_rendered": "<p>Los padres razonaron que el gobierno cívico...</p>",
      "language": "es",
      "namespace": "mai",
      "documents": {
        "id": "doc-xyz789",
        "title": "El Concilio de Nicea",
        "author": "...",
        "publication_date": "1995",
        "document_format": "PDF",
        "scope": "organization"
      }
    }
  ],
  "count": 42,
  "error": null
}

Búsqueda por palabras clave

Encuentra pasajes que contengan las palabras literales. Establece mode=keyword:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=Constantino" \
  --data-urlencode "mode=keyword" \
  --data-urlencode "per_page=10"

Filtrado

Añade filtros mediante parámetros de consulta:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=gracia" \
  --data-urlencode "author=Agustín" \
  --data-urlencode "mode=neural"

Filtros disponibles: author, publication_date (año), isbn, id (ID de documento para coincidencia exacta) y document_id (para buscar dentro de un solo documento).

Elegir bibliotecas

El parámetro de consulta libraries restringe la búsqueda a una o más Bibliotecas. Pásalo como parámetro de consulta repetido:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=calendario litúrgico" \
  --data-urlencode "libraries=mai" \
  --data-urlencode "libraries=orientale"

Si se omite libraries, la API usa tu biblioteca privada por defecto.

Buscar documentos (no pasajes)

Para listar documentos que coincidan por título en lugar de devolver pasajes individuales, usa /api/search/documents:

curl -G "https://vulgate.ai/api/search/documents" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=Eucaristía" \
  --data-urlencode "per_page=20"

Paginación

Usa page (indexado desde 1) y per_page (máximo 100) para navegar el conjunto de resultados:

?search=teología&per_page=20&page=2

El campo count de la respuesta es un total estimado — adecuado para interfaces de paginación.

Relacionado

Buscar ayuda