REreacherapp
AI Search

Find creators similar to seed creators (lookalike mode)

Changed on

Find creators similar to a seed set. Seed from any of: seed_creator_ids (handles or ids, up to 50), a seed_crm_group_id, a seed_list_id, or a text query. CRM group / list seeds are resolved to creators server-side, scoped to your shop. Seeds are excluded from the results. Requires a single x-shop-id; availability is gated per region.

post/ai-search/lookalike

Request

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

Request body

seed_creator_idsstring[] nullable

Seed creators (TikTok handles or ids), up to 50. The result set is creators similar to these seeds.

seed_crm_group_idstring nullable

Seed from an existing CRM group's members (resolved server-side, scoped to your shop).

seed_list_idinteger nullable

Seed from a saved list's members (resolved server-side, scoped to your shop).

querystring nullable

Text-description lookalike: describe the kind of creator to find. Used when no seed cohort is supplied.

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_lookalike_ai_search_lookalike_post removed and replaced with ai_search_lookalike

    • 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