RecruitAffiliates.ai

Start a clone search

Clone your best affiliates, step two. Spends one search credit and looks for creators like the ones you send, on the profile you send. Leave profile out and the creators are read again first, free, as POST /searches/clone-profile would.

Poll GET /searches/{id} like any search. If it can't start, the credit comes back straight away and the search answers failed with credit_refunded: true. A profile with no topic, brand or hashtag is refused with profile_empty before anything is spent.

Send an Idempotency-Key: a retry with the same key answers the first search and never spends twice.

A test key answers a queued search that is stored nowhere and never runs. It spends nothing.

Answers 404 feature_off while clone search isn't switched on for the deployment.

Scope: finder:write

post/v1/finder/searches/clone

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/finder/searches/clone
  • Auth: HTTP bearer

Request body

brand_idstring

Which brand. Defaults to the organization's oldest.

seedsstring[]

Links to creators you already rate, one per item: a website, a YouTube channel, an Instagram or TikTok profile, a newsletter or a podcast. A bare @name is refused, because it could be anyone on three platforms.

prospect_idsstring[]

Or pick them from your own prospects. Ten creators at most, pasted and picked together.

countrystring required

ISO 3166-1 alpha-2, like GB or US

Example request

{
  "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK",
  "prospect_ids": [
    "fdi_7uSyy9FqVLCFWrdPeZaK"
  ]
}

Response

The search

idstring required

Prefixed id (fsc_…)

object'finder_search' required
brand_idstring required

Prefixed id (fbr_…)

type'topic' | 'competitor' | 'lookalike' | 'clone' required
seedstring required

What was searched: the topic, the competitor's domain or handle, the YouTube channel, or for clone the creators it started from

countrystring nullable required

Topic and clone searches only

labelstring required

What the app calls it in Recent searches

state'queued' | 'running' | 'done' | 'failed' | 'stopped_at_ceiling' required
foundinteger required
errorstring nullable required
credit_refundedboolean required

True when the search failed and its credit came back

created_atstring date-time required

ISO-8601, UTC

finished_atstring date-time nullable required

ISO-8601, UTC

livemodeboolean required

Example response

{
  "id": "fsc_7uSyy9FqVLCFWrdPeZaK",
  "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK",
  "created_at": "2026-08-21T10:15:30.000Z",
  "finished_at": "2026-08-21T10:15:30.000Z"
}

Changes

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