REreacherapp
Workflows

Preview an AI Creator Search

Changed on

Who an ai_creator_search step would bring in first for this query and mode: creators new to the shop's CRM, past the settings' exclusions, best match first. Nothing is written and nobody is enrolled. Check a description here before putting it in a step — a query the search refuses answers 400 now rather than failing every scheduled run. An empty creators list means nobody matched for this shop. The search itself can take up to two minutes, and 502 SEARCH_UNAVAILABLE means it could not run — not that nobody matched. 429 means too many searches are already in flight; retry rather than rewording.

post/workflows/search-preview

Request

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

Request body

querystring required

What the creators you want look like, in plain words — the same description an ai_creator_search step carries in its query.

mode'profile' | 'transcript'

profile matches a creator's bio and category; transcript matches what they say in their videos. Transcript search is switched off in some environments and answers 502 there.

workflow_idstring nullable

A saved workflow of this shop. Supply it to leave out the creators that workflow has already admitted, as one of its runs would.

settingsobject nullable

Only exclusions changes the answer here; the rest is ignored.

limitinteger

How many creators to name back.

Response

Successful Response

Changes