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
  }
]