Skip to main content
POST
Error

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
projectId
string<uuid>
required
​
platform
enum<string>
required
Available options:
TELEGRAM
​
prompt
string
required

The advertiser's own words for the channels he wants, e.g. "TON and DeFI channels, 20K+ subscribers, English-speaking traders, no giveaway posts". One sentence like this carries three different kinds of requirement, and each is routed to where it can actually be enforced: the subject matter becomes the semantic query, the audience language becomes the parser's language filter, the stated numbers become audience filters (reported back in filters), and the negations become instructions to the relevance classifier, which is the only step that can honour a "no ...". Unlike match-channels this needs no project AI context: the prompt says everything. projectId is still required because the returned matchToken is bound to it.

Required string length: 1 - 2000
​
objective
enum<string> | null
Available options:
AWARENESS,
TRAFFIC,
CONVERSIONS,
APP_INSTALLS

Response

Success

​
matchToken
string
required
​
channels
object[]
required
​
filters
object | null

Present only for match-channels-by-prompt, which is the only search that INFERS its filters instead of being told them: it reports back what it read out of the prompt. The ad-copy and look-alike searches take no filters from the caller, so they leave this absent.