RecruitAffiliates.ai

Retrieve a search

One search and its state: queued, running, done, failed (credit refunded) or stopped_at_ceiling.

Scope: finder:read (or finder:write)

get/v1/finder/searches/{id}

Request

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

Path parameters

idstring required

Prefixed id (fsc_…)

Example:fsc_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.