Create exclusion list

Request

Creates a new specific exclusion list for the given platform and returns its id. Use specific lists for handles you want to apply selectively; for a standing, always-on blocklist use the platform's default list instead. After creating a list, add handles via /exclusion-lists/{list_id}/entries/, then apply it to a search by passing its ID in exclude_list in the Discovery or Similar Creators filters. This operation is free — it does not consume credits.

Security

Bearer

Body

required

namestringrequired

Human-readable name for the new exclusion list.

platformstringrequired

The social media platform this list applies to.

Enum:"instagram""youtube""tiktok""twitch""twitter""onlyfans"

curl -i -X POST \
  https://api-dashboard.influencers.club/public/v1/discovery/exclusion-lists/ \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "platform": "instagram"
  }'

Responses

Bodyapplication/json

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"
}