List handles in a specific exclusion list

Request

Returns a paginated list of handles in the specific exclusion list. Defaults to the first 1,000 handles; use offset and limit to page through larger lists. Handles are returned in alphabetical order.

Security

Bearer

Path

list_idintegerrequired

The exclusion list's unique identifier.

Query

offsetinteger, >= 0

Number of handles to skip from the start of the list.

Default:0

limitinteger, [ 1 .. 10000 ]

Maximum number of handles to return (1–10,000).

Default:1000

curl -i -X GET \
  'https://api-dashboard.influencers.club/public/v1/discovery/exclusion-lists/{list_id}/entries/?offset=0&limit=1000' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json

totalintegerrequired

Total number of handles in the list.

Example:3

offsetintegerrequired

Offset applied to this page of handles.

Example:0

limitintegerrequired

Limit applied to this page of handles.

Example:1000

handlesArray of stringsrequired

The requested page of handles, sorted alphabetically.

Example:

[
  "creator_one",
  "creator_three",
  "creator_two"
]

Response

{
  "total": 3,
  "offset": 0,
  "limit": 1000,
  "handles": [
    "creator_one",
    "creator_three",
    "creator_two"
  ]
}