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
seedChannelIds
integer<int64>[]
required

The channels to look for look-alikes of. They are averaged into ONE query point, not searched for one by one: seeds that sit close to each other describe a single kind of channel and give a sharp result, while scattered seeds average out into a vague point in the middle and give a vague one. Pick channels that belong together. A seed whose vector the parser does not know is skipped. The seeds never come back among the look-alikes themselves — a seed is its own closest look-alike and would fill the top of the answer — they are re-added from matchToken when one is given.

Required array length: 1 - 50 elements
matchToken
string | null

The token of the search the seeds were picked from. Given it, the seeds are carried over into the new list — at its head, with relevancy 1 — so that a look-alike search EXTENDS the advertiser's selection instead of replacing it. Campaign create consumes exactly one token and buys exactly the channels cached under it, so a seed missing from the newest list cannot be bought at all. Omitted, or naming a search that has since expired, the response carries the look-alikes alone. A token belonging to another user, project or platform is refused.

limit
integer<int32> | null

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.