TikTok Account Exclusion lists filter API
Find TikTok profiles by exclusion lists filter from 23.1M searchable profiles
Is there an API to use exclusion lists in TikTok discovery?
Yes. The Influencers.club Discovery API filters TikTok creator profiles by saved suppression — platform-scoped exclusion lists applied by ID. Create lists once, then reference them by ID in any search — with exclude_default_list and exclude_all_lists as one-flag shortcuts — and get back full profiles with follower counts, engagement rates and verified contact data.
Make the call
Both samples below are complete. Paste one in, swap the key, get a 200.
https://api-dashboard.influencers.club/public/v1/discovery/
Authorization: Bearer <API_KEY>
Content type application/json
Rate 0.01 credits per creator returned
Full reference →
What comes back
A 200 with the page of creators and your remaining credit balance. Creator values below are elided — field names and types are exactly as published in the API schema.
The spec
| Parameter | Type | Accepted values | Behaviour |
|---|---|---|---|
| filters.exclude_list | array | true — false or omitting the flag has no effect | Combine with any other filter; the flag only filters in one direction. |
| platform | string | instagram · youtube · tiktok · twitch · twitter · onlyfans | Required. Selects the platform-specific filter set. |
| paging.limit / paging.page | integer | Any positive integer | Required. Page numbering starts at 0. |
| sort.sort_by / sort.sort_order | string | relevancy · asc / desc | Optional. Defaults to descending. |
| return_filter_values | boolean | true · false | Adds the matched filter values to each creator. Bills 0.03 credits instead of 0.01. |
Billing. 0.01 credits per creator returned. If no creators are returned, no credits are deducted.
Exclusion lists filter is rarely the only filter
Three combinations that people actually send. Every filter below exists today.
Suppression that persists across searches
Build the do-not-contact list once, apply it everywhere.
filters: {
"exclude_list": ["list_id"], "exclude_default_list": true,
"engagement_percent": { "min": 2 } }
Team-wide clean pipelines
Everyone’s searches respect the same exclusions.
filters: {
"exclude_list": ["list_id"], "exclude_default_list": true,
"has_link_in_bio": true }
Always-fresh mid-tier prospecting
Default lists keep every query deduplicated.
filters: {
"exclude_list": ["list_id"], "exclude_default_list": true,
"number_of_followers": { "min": 10000, "max": 100000 } }
Other TikTok data you can access
TikTok API endpoints
Six platforms with full data, 40+ more in the social graph
Instagramdiscovery · full data
TikTokdiscovery · full data
YouTubediscovery · full data
X / Twitterdiscovery · full data
Twitchdiscovery · full data
OnlyFansdiscovery · full dataPlus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.
Frequently asked questions
Which values does the filter accept?+
It’s a boolean. Set it to true and only matching creators are returned. Setting it to false, or leaving it out, has no effect — the flag only filters in one direction.
Where can I find my API key?+
Create a free account. You will find your API key through the API side menu.
How do I find TikTok creators using exclusion lists using your API?+
Simply sign up for free, copy your API key, then POST to the Discovery endpoint with filters.exclude_list set. You’ll get TikTok profiles ready to be ingested for your use case.
What are your pricing plans and what do they include?+
Paid plans start at $249/month and use a flexible credit-based model.
Each API call consumes a specific number of credits depending on the endpoint and data depth. You can compare all tiers, credit amounts, and per-endpoint costs in the Pricing section of our API docs.
How can I get in touch with your team?+
Book a time on our calendar to talk to someone from our team and learn about the full capabilities of our API.