Sign in
Exclusion lists

Create exclusion list

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.

post/public/v1/discovery/exclusion-lists/

Request body

namestring required

Human-readable name for the new exclusion list.

platform'instagram' | 'youtube' | 'tiktok' | 'twitch' | 'twitter' | 'onlyfans' required

The social media platform this list applies to.

Response

idinteger required

The exclusion list's unique identifier.

namestring required

Human-readable name of the exclusion list.

platformstring required

The social media platform this list applies to.

is_defaultboolean required

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

handle_countinteger required

Number of handles currently in the list.

created_atstring date-time required

When the list was created.

updated_atstring date-time required

When the list was last modified.

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

Changes

Changed in 1 of the 3 revisions of this API.3

  • 87e654ac822e3See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    This revision also has 13 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog