Query Datasets
| Field | Type | Required | Description |
|---|---|---|---|
query | string | One of query/vector | Natural language search text |
vector | number[] | One of query/vector | Pre-computed embedding |
dataset_ids | string[] | Yes | Dataset IDs to search |
top_k | number | No (default 10) | Max results (max 100) |
filters | object | No | Per-dataset metadata filters |
| Field | Type | Description |
|---|---|---|
dataset_id | string | Source dataset |
id | string | Vector ID in the seller’s DB |
score | number | Relevance score (higher = better) |
metadata | object | Key-value pairs from the seller’s vector DB |
embedding_model | string | Only in multi-model queries |
200— success400— validation error (bad filters, missing fields, dimension mismatch)402— insufficient balance (includesbalanceandestimated_cost)403— no access to one or more datasets