Skip to main content
GET
List searches

Authorizations

X-API-Key
string
header
required

API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.

Query Parameters

kind
enum<string>

Filter to query searches or similarity lookups.

Available options:
search,
similar
status
enum<string>

Filter by outcome.

Available options:
completed,
failed,
in_progress
depth
enum<string>

Filter query searches by depth.

Available options:
fast,
deep
q
string

Free-text filter over the query text.

api_key_id
string

Only searches made with one API key. Useful for separating environments that share an account.

limit
integer
default:20

Maximum number of searches to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of searches to skip, for pagination.

Required range: x >= 0

Response

A page of past searches.

submissions
object[]

Past searches, newest first.

total
integer

Total searches matching the filter, ignoring pagination.

total_by_status
object

Counts by outcome under the other filters, ignoring pagination, so a status picker can label its options.

limit
integer
offset
integer