REreacherapp
AI Search

Search creators by visual content (video mode)

Changed on

Find creators whose video content matches a text description and/or a reference image. Supply query, a base64 image, or both (at least one is required). For binary file uploads use the multipart POST /ai-search/video/upload endpoint instead. Requires a single x-shop-id; availability is gated per region.

post/ai-search/video

Request

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

Request body

querystring nullable

Natural-language description of the visual content to match. Optional if 'image' is supplied.

imagestring nullable

Base64-encoded reference image (PNG/JPG/WebP, <=10MB decoded). Optional if 'query' is supplied. A raw 'data:<mime>;base64,' prefix is accepted.

filtersobject nullable

Optional creator filters, 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_video_ai_search_video_post removed and replaced with ai_search_video

    • 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