Skip to main content
POST
/
api
/
v1
/
search
/
text-store
/
stores
/
{store_name}
/
search
Typescript (SDK)
import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.search.textStore.searchTexts({
    storeName: "<value>",
    xApiKeyId: "<id>",
    xUserId: "<id>",
    xExchangeJwtExternalUserId: "<id>",
    searchTextRequest: {
      query: "noise-cancelling headphones",
      vector: [
        0.16,
        -0.08,
        0.29,
      ],
      limit: 5,
    },
  });

  console.log(result);
}

run();
{
  "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

Authenticate with your MKA1 API key at the API gateway: Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, also send X-On-Behalf-Of to identify the end user making the request.

Headers

X-On-Behalf-Of
string

Optional external user identifier for multi-user server-side integrations. Use this when acting on behalf of one of your end users.

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