Skip to main content
POST
/
api
/
datastores
/
{datastoreId}
/
query
curl -X POST https://app.horneross.com/api/datastores/ds_abc123/query \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "política de devoluciones",
    "topK": 3
  }'
[
  {
    "text": "Podés devolver tu producto dentro de los 30 días desde la compra. El producto debe estar sin uso y en su empaque original.",
    "score": 0.95,
    "source": "https://ejemplo.com/politicas",
    "datasource_name": "Políticas de la empresa",
    "datasource_id": "datasource_xyz",
    "custom_id": "politica_devoluciones",
    "offset": 0
  }
]

Endpoint

POST /api/datastores/{datastoreId}/query

Path Parameters

datastoreId
string
required
ID único del datastore donde realizar la búsqueda.

Headers

Authorization
string
required
Bearer token con tu API key o API key del datastore.
Content-Type
string
required
Siempre application/json

Request Body

query
string
required
Texto de búsqueda. El sistema encuentra documentos semánticamente similares.
topK
number
default:"5"
Cantidad de resultados a retornar. Máximo 20.
filters
object
Filtros de metadata para refinar la búsqueda.
curl -X POST https://app.horneross.com/api/datastores/ds_abc123/query \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "política de devoluciones",
    "topK": 3
  }'

Response

results
array
required
Array de documentos encontrados ordenados por relevancia.
[
  {
    "text": "Podés devolver tu producto dentro de los 30 días desde la compra. El producto debe estar sin uso y en su empaque original.",
    "score": 0.95,
    "source": "https://ejemplo.com/politicas",
    "datasource_name": "Políticas de la empresa",
    "datasource_id": "datasource_xyz",
    "custom_id": "politica_devoluciones",
    "offset": 0
  }
]