Skip to content

Exclusion lists

Manage lists of creator handles to exclude from Discovery and Similar Creators results.

Default vs specific lists. Every team gets one default list per platform (Instagram, TikTok, etc.). It is created automatically the first time you touch it, you address it by platform — e.g. GET /exclusion-lists/default/instagram/ — and it cannot be deleted; think of it as your standing blocklist. You can also create specific lists when one list is not enough — e.g. "Q4 campaign blocklist", "competitor handles", "do-not-contact". Specific lists get an id and are managed via /exclusion-lists/{list_id}/…; you can rename or delete them.

Adding handles alone does not filter search. To actually filter Discovery or Similar Creators, pass one of these in filters:

  • exclude_list: [42, 57] — apply those list IDs
  • exclude_default_list: true — apply the platform's default list
  • exclude_all_lists: true — apply every list for that platform

Example flow

  1. POST /exclusion-lists/ with { "name": "Competitors", "platform": "instagram" } → returns id: 42
  2. POST /exclusion-lists/42/entries/ with { "handles": ["brand_x", "brand_y"] }
  3. POST /discovery/ with filters.exclude_list: [42] — brand_x and brand_y are now filtered out.

For the default list, skip step 1: POST /exclusion-lists/default/instagram/entries/, then search with filters.exclude_default_list: true.

Operations

List exclusion lists

Request

Returns all exclusion lists available to your team, each scoped to a single platform. This includes both the auto-created default list per platform and any specific lists you have created. Adding handles to a list does not filter search on its own — apply a list to a search by passing exclude_list (list IDs), exclude_default_list, or exclude_all_lists in the Discovery or Similar Creators filters.

Security
Bearer
GET
/public/v1/discovery/exclusion-lists/
curl -i -X GET \
  https://api-dashboard.influencers.club/public/v1/discovery/exclusion-lists/ \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
Array [
idintegerrequired

The exclusion list's unique identifier.

Example:42
namestringrequired

Human-readable name of the exclusion list.

Example:"Blocklist Q4"
platformstringrequired

The social media platform this list applies to.

Example:"instagram"
is_defaultbooleanrequired

Whether this is the team's default list for the platform.

Example:false
handle_countintegerrequired

Number of handles currently in the list.

Example:3
created_atstring, (date-time)required

When the list was created.

Example:"2026-01-15T09:30:00Z"
updated_atstring, (date-time)required

When the list was last modified.

Example:"2026-01-20T14:05:00Z"
]
Response
[
  {
    "id": 42,
    "name": "Blocklist Q4",
    "platform": "instagram",
    "is_default": false,
    "handle_count": 3,
    "created_at": "2026-01-15T09:30:00Z",
    "updated_at": "2026-01-20T14:05:00Z"
  }
]