RecruitAffiliates.ai

List saved prospects

Saved's three views: saved (default), deals (saved with a deal) and hidden (ruled out, restorable).

Scope: finder:read (or finder:write)

get/v1/finder/saved

Request

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

Query parameters

brand_idstring

Which brand. Defaults to the organization's oldest.

Example:fbr_7uSyy9FqVLCFWrdPeZaK
view'saved' | 'deals' | 'hidden'

Default saved

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

Saved 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.