REreacherapp
AI Search

Search creators by what they say (transcript mode)

Changed on

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

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/ai-search/transcript
  • Auth
    API key in header x-api-key and API key in header x-shop-id

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

  • 291230805105Revision changes
    • info

      api operation id search_transcript_ai_search_transcript_post removed and replaced with ai_search_transcript

    • info

      added the optional property / to the response with the status

    • info

      response property pagination/total deprecated

    • info

      added the required property / to the response with the status