{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-openapi.yaml","sidebar":"sidebar-sidebars.yaml"},"props":{"definitionId":"openapi.yaml","dynamicMarkdocComponents":[],"baseSlug":"/openapi","seo":{"title":"Exclusion lists","siteUrl":"https://docs.influencers.club","projectTitle":"Creator Discovery & Enrichment","description":"Manage lists of creator handles to exclude from Discovery and Similar Creators results.\n\n**Default vs specific lists.** Every team gets one *default* list per platform (Instagram, TikTok, etc.). It is created automatically the first time you touch it, you address it by platform — e.g. `GET /exclusion-lists/default/instagram/` — and it cannot be deleted; think of it as your standing blocklist. You can also create *specific* lists when one list is not enough — e.g. \"Q4 campaign blocklist\", \"competitor handles\", \"do-not-contact\". Specific lists get an `id` and are managed via `/exclusion-lists/{list_id}/…`; you can rename or delete them.\n\n**Adding handles alone does not filter search.** To actually filter Discovery or Similar Creators, pass one of these in `filters`:\n\n- `exclude_list: [42, 57]` — apply those list IDs\n- `exclude_default_list: true` — apply the platform's default list\n- `exclude_all_lists: true` — apply every list for that platform\n\n**Example flow**\n\n1. `POST /exclusion-lists/` with `{ \"name\": \"Competitors\", \"platform\": \"instagram\" }` → returns `id: 42`\n2. `POST /exclusion-lists/42/entries/` with `{ \"handles\": [\"brand_x\", \"brand_y\"] }`\n3. `POST /discovery/` with `filters.exclude_list: [42]` — `brand_x` and `brand_y` are now filtered out.\n\nFor the default list, skip step 1: `POST /exclusion-lists/default/instagram/entries/`, then search with `filters.exclude_default_list: true`.","lang":"en-US","keywords":["influencer api","creator discovery api","influencer enrichment api","creator analytics api","influencer search api","influencers club api"],"image":"/assets/social-card.47b21fb9c6cc6c6d66f301d067e34b9685afb6d966674e28900a8292b9679bf8.925ff8b2.png","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Influencers Club","url":"https://influencers.club"},"meta":[{"name":"og:site_name","content":"Influencers Club"},{"name":"google-site-verification","content":"ZWg0YNniQGWhs61QvMFgZn4P4_ur1voyXFygBnMBomo"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"itemId":"exclusion-lists","disableAutoScroll":true,"metadata":{"subType":"openapi-operation"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.influencers.club","port":4000,"ipAddress":"216.73.216.114"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/openapi/exclusion-lists","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}