RecruitAffiliates.ai

List prospects

The brand's prospects in one view (discover by default), with the app's filters and sorts. total_count counts the rows matching the filters. With the one list on, discover holds every row the scans kept, best fit first, and possible is always empty.

Scope: finder:read (or finder:write)

get/v1/finder/prospects

Request

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

Query parameters

brand_idstring

Which brand. Defaults to the organization's oldest.

Example:fbr_7uSyy9FqVLCFWrdPeZaK
view'discover' | 'possible' | 'saved' | 'deals' | 'hidden' | 'existing' | 'customers'

Default discover: matches scoring 60 and over, not saved-away, not hidden

channel'website' | 'youtube' | 'podcast' | 'instagram' | 'tiktok'
fit'strong' | 'good' | 'possible' | 'weak'
searchstring

Matches a name, domain or handle

countrystring
languagestring
competitorstring

Only prospects whose content names this competitor

stage'saved' | 'contacting' | 'replied' | 'negotiating' | 'onboarding' | 'activated' | 'no_reply' | 'declined' | 'on_hold'
has_email'true' | 'false'
assigneestring

A user id, or unassigned

list_idstring

Prefixed id (fls_…)

Example:fls_7uSyy9FqVLCFWrdPeZaK
sort'fit' | 'audience' | 'relevance' | 'published' | 'discovered'

Default fit: best score first

limitstring

1 to 100, default 25

Example:25
cursorstring

next_cursor from the previous page, with the same filters

Response

Prospects

has_moreboolean required

True when next_cursor fetches more

total_countinteger required

Every object matching the filters, ignoring the cursor

next_cursorstring nullable required

Pass as cursor with the same filters to get the next page. Null on the last page.

Example response

{
  "data": [
    {
      "id": "fdi_7uSyy9FqVLCFWrdPeZaK",
      "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK",
      "evidence": [
        {
          "published_at": "2026-08-21T10:15:30.000Z"
        }
      ],
      "saved_at": "2026-08-21T10:15:30.000Z",
      "hidden_at": "2026-08-21T10:15:30.000Z",
      "email_revealed_at": "2026-08-21T10:15:30.000Z",
      "deal": {
        "id": "fdl_7uSyy9FqVLCFWrdPeZaK"
      },
      "last_seen_at": "2026-08-21T10:15:30.000Z",
      "created_at": "2026-08-21T10:15:30.000Z",
      "updated_at": "2026-08-21T10:15:30.000Z"
    }
  ]
}

Changes

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