Skip to main content
POST
/
api
/
v1
/
search
/
text-store
/
stores
/
{store_name}
/
search
Python (SDK)
from mka1 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
}

Authorizations

Authorization
string
header
required

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>.

Headers

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

Path Parameters

store_name
string
required

Body

application/json

Request to search for similar texts.

query
string
required

Query text for full-text search

Minimum string length: 1
vector
number[]
required

Query embedding vector for semantic search

Minimum array length: 1
limit
integer
default:10

Maximum number of results to return

Required range: 1 <= x <= 100

Response

Successful Response

Response with search results.

results
SearchTextResult · object[]
required

Ordered search results

total
integer
required

Number of returned results

search_time_ms
integer
required

Search latency in milliseconds