Saltar al contenido principal
POST
/
api
/
v1
/
search
/
text-store
/
stores
/
{store_name}
/
search
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.search.text_store.search_texts(store_name="<value>", x_api_key_id="<id>", x_user_id="<id>", x_exchange_jwt_external_user_id="<id>", query="noise-cancelling headphones", vector=[
        0.16,
        -0.08,
        0.29,
    ], limit=5)

    # Handle response
    print(res)
{
  "results": [
    {
      "group": "electronics_q1_2026",
      "score": 0.9321,
      "text": "Wireless noise-cancelling headphones with 30-hour battery life"
    }
  ],
  "search_time_ms": 24,
  "total": 1
}

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

x-api-key-id
string
requerido
x-user-id
string
requerido
x-exchange-jwt-external-user-id
string
requerido

Parámetros de ruta

store_name
string
requerido

Cuerpo

application/json

Solicitud para buscar textos similares.

query
string
requerido

Texto de consulta para búsqueda de texto completo

Minimum string length: 1
vector
number[]
requerido

Vector de incrustación de consulta para búsqueda semántica

Minimum array length: 1
limit
integer
predeterminado:10

Número máximo de resultados a devolver

Rango requerido: 1 <= x <= 100

Respuesta

Respuesta exitosa

Respuesta con resultados de búsqueda.

results
SearchTextResult · object[]
requerido

Resultados de búsqueda ordenados

total
integer
requerido

Número de resultados devueltos

search_time_ms
integer
requerido

Latencia de búsqueda en milisegundos