---
title: "List Saved Influencers Endpoint"
method: GET
path: "/api/v1/remy/saved-influencers"
tags: ["remy"]
---

# List Saved Influencers Endpoint

`GET /api/v1/remy/saved-influencers`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/saved-influencers`
- Auth: HTTP bearer

Saved Influencers list, paginated — shared-corpus accounts see the whole pool, others only their own roster.

## Query parameters

- `search` string, nullable: Handle or full name substring, case-insensitive.
- `followers` string[], nullable: Bands: under_10k|10k_100k|100k_500k|500k_1m|1m_plus. Multi-select OR'd.
- `engagement_rate_min` number, nullable: Minimum engagement rate percent — per view on YouTube, per follower elsewhere. Creators with no measured ER are excluded.
- `language` string[], nullable: Multi-select OR'd.
- `category` string[], nullable: Bucket name or raw category. Multi-select OR'd.
- `subcategory` string[], nullable: Normalized subcategory, e.g. Acne Care or Bodybuilding. Multi-select OR'd.
- `followership` string[], nullable: Bucket name or raw country. Multi-select OR'd.
- `platform` string[], nullable: e.g. instagram, youtube. Multi-select OR'd.
- `location` string[], nullable: Creator's own country, e.g. India, United States. Multi-select OR'd.
- `is_brand_kit_available` boolean, nullable: T2/brand-kit presence filter. Omitted (default) = both. true = only creators whose brand kit holds data, as the row's pricing tab shows it. false = only those without. Complete pricing is roster_gap=missing_pricing instead.
- `is_email_sendable` boolean, nullable: Whether this creator can actually be emailed. Omitted (default) = both. true = only creators with a real, non-suppressed email contact — what the invite send resolves against. Not profile.has_email, which is a stored hint that drifts.
- `roster_gap` 'missing_general' | 'missing_pricing' | 'missing_campaign'
- `is_campaign_proof_available` boolean, nullable: Creator-reported past campaigns (Elite form) presence filter. Omitted (default) = both. false = only creators who have not told us their past campaigns — the roster's 'no past campaigns' gap. Not creator.campaign_status, which tracks the team's own CSV-uploaded attribution data instead.
- `is_analysis_available` boolean, nullable: T3/analysis presence filter. Omitted (default) = both. true = only creators with a completed analysis. false = only those without.
- `is_recently_added` boolean, nullable: Creators this user added to their roster in the last 48 hours. Omitted (default) = all. true = only those, newest addition first. false = everyone else.
- `view` 'full' | 'compact'
- `page` integer
- `size` integer

## Response `200`

Successful Response

- PageSavedInfluencerDTO
  - `items` SavedInfluencerDTO[], required
    - `creator_id` string, required
    - `profile_id` string, nullable
    - `roster_gap` string, nullable
    - `added_to_roster_at` string, date-time, nullable
    - `first_added_at` string, date-time, nullable
    - `is_recently_added` boolean
    - `is_added_again` boolean
    - `platform` string, nullable
    - `handle` string, nullable
    - `display_name` string, nullable
    - `profile_pic_url` string, nullable
    - `followership` string, nullable
    - `plan` string, nullable
    - `has_email` boolean, nullable
    - `email_id` string, nullable
    - `has_phone_number` boolean, nullable
    - `phone_number` string, nullable
    - `general_data` object, required
    - `pricing_data` union, required
      - object
      - string
    - `campaign_data` union, required
      - object[]
      - string
    - `analysis_data` union, required
      - object
      - string
    - `other_platforms` object[]
    - `platform_data` object, nullable
    - `derived_metrics` object, nullable
  - `total` integer, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

> 37 revisions in range; 1 not diffed.

- **2026-10-23** `4ed60a24dd66`: 2 info
  - added the optional property `items/items/first_added_at` to the response with the `200` status
  - added the optional property `items/items/is_added_again` to the response with the `200` status
- **2026-10-23** `a7541d591c33`: 3 info
  - added the new optional `query` request parameter `is_recently_added`
  - added the optional property `items/items/added_to_roster_at` to the response with the `200` status
  - added the optional property `items/items/is_recently_added` to the response with the `200` status
- **2026-10-13** `c7202552278d`: 1 info
  - added the new optional `query` request parameter `view`
- **2026-09-30** `05ad3a41b4cf`: 1 info
  - added the optional property `items/items/derived_metrics` to the response with the `200` status
- **2026-09-21** `a6cea1834b97`: 5 info
  - added the optional property `items/items/email_id` to the response with the `200` status
  - added the optional property `items/items/has_email` to the response with the `200` status
  - added the optional property `items/items/has_phone_number` to the response with the `200` status
  - added the optional property `items/items/phone_number` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/remy/saved-influencers/get.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)