v1

latestOpenAPI 3.0.32026-08-0670174396.8 KB

Exclusion lists

List exclusion lists

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.

get/public/v1/discovery/exclusion-lists/

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