Skip to main content
POST
Several catalog searches in one call: one page per query, the filters shared (ADR 0220).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
queries
string[]
required

1–10 searches, one per need, each in the user's own words: one page each, in this order.

Required array length: 1 - 10 elements
Required string length: 1 - 500
category
string

One of llm, image, video, 3d, audio, web, data, social-media, e-commerce, finance, lead-gen, public-records, listings, maps-reviews, seo, news-media, developer, sports, industry-data, health, or several separated by commas (image,video): a tool in any of them.

exclude_category
string

Categories to leave out, separated by commas (llm,data); with category, both apply.

provider
string

A provider id, or several separated by commas (fal,replicate): a tool of any of them.

exclude_provider
string

Provider ids to leave out, separated by commas (tikhub,scrapecreators).

execution
enum<string>

Only tools that answer in the run's response (sync) or by webhook and polling (async).

Available options:
sync,
async
include_deprecated

false: leave out deprecated tools (deprecated_at set; they retire at retires_at). Omitted or true: keep them.

include_disabled

true: also list the tools this organization or key may not run (allowed: false: the tool or its provider is turned off). Omitted or false: only tools it may run.

url
string

A page or a host (https://www.amazon.com/dp/B0…, tiktok.com): only the tools made for that site, named by their id (Alexandria's domain tools, ScrapeCreators' and TikHub's platform tools).

Maximum string length: 2048
facets

true: add facets, the counts by category and provider of the tools matching every word, to narrow the next search.

availability
enum<string>

Deprecated (ADR 0187): every listed tool is live, so live keeps them all and preview none.

Available options:
live,
preview
priced

Deprecated (ADR 0223): every listed tool is priceable, so it changes nothing; still accepted.

released_after
string<date>

YYYY-MM-DD: only tools first released on or after this day (release_date). Tools without a known release date are left out.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
released_before
string<date>

YYYY-MM-DD: only tools first released on or before this day (release_date). Tools without a known release date are left out.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
sort
enum<string>

relevance (the default): best match first. newest: latest release_date first, tools without one last; with q, tools matching every word still come before those matching some.

Available options:
relevance,
newest
limit
integer

1–list.max_limit (100), default list.default_limit (20).

Required range: 1 <= x <= 100

Response

One page of models per query, in order.

object
string
required
Allowed value: "list"
results
object[]
required