Search creators by what they say (transcript mode)

Find creators whose video transcripts match a natural-language phrase. match_sources selects spoken audio and/or on-screen text (defaults to audio). Matched videos carry match_type and a snippet. Requires a single x-shop-id; availability is gated per region.

post/ai-search/transcript

Request body

querystring required

Natural-language phrase to match against creator video transcripts (required).

match_sourcesstring[]

Which transcript sources to search: 'audio' (spoken words) and/or 'video' (on-screen text). Defaults to ['audio']. Duplicates are de-duplicated.

filtersobject nullable

Optional creator filters (categories, follower/GMV ranges, etc.), same shape as the portal search filters. post_rate is on a 0–100 scale (sample-fulfillment %). Unrecognized filter keys are rejected with a 400 rather than silently ignored.

pageinteger

page_sizeinteger

Response

Successful Response

exact_handle_matchboolean

True iff the query was an exact creator handle (or a short brand name that resolves to one) and that creator was pinned as the first result. Lets a client show an 'exact creator found' affordance and offer a full semantic search via disable_handle_pin=true.

exact_handlestring nullable

The normalized handle that matched (e.g. 'kriseatsnyc'), or null when there was no exact-handle pin.

Changes

No recorded changes to this endpoint across all 1 revision of this API.