Skip to main content
GET
Get global filters

Authorizations

Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.

Response

200 response

Org-wide filter lists. Applied on top of per-keyword exclusions and always active.

negativeKeywords
string[]
required

Words, phrases, or @handle / $TICKER tokens that disqualify a mention org-wide. Matched case-insensitively as whole words against the post title + body.

Maximum array length: 2000

Word, phrase, or @handle / $TICKER token. Trimmed; 1-200 chars.

Required string length: 1 - 200
Example:
negativeAuthors
string[]
required

Author handles/usernames to filter out org-wide. Matched case-sensitively as an exact string against the post's author field.

Maximum array length: 2000

Author handle/username exactly as it appears on mention.author. Don't add a leading @ unless the platform does (Twitter stores handles without @; Reddit stores usernames as-is; YouTube uses channel titles).

Required string length: 1 - 200
Example:
negativeSubreddits
string[]
required

Subreddit names to exclude. r/ prefix is optional — both nextjs and r/nextjs are accepted and stored in canonical form. Matched case-insensitively.

Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

Required string length: 1 - 50
Pattern: ^[A-Za-z0-9_]+$
Example:
positiveSubreddits
string[]
required

Subreddit allowlist. r/ prefix is optional. When non-empty, Reddit mentions are restricted to these subreddits only; empty array means all subreddits pass.

Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

Required string length: 1 - 50
Pattern: ^[A-Za-z0-9_]+$
Example:
negativeRepos
string[]
required

GitHub repos to exclude in owner/name form. Matched case-insensitively against the repo parsed from the GitHub URL.

Maximum array length: 2000

GitHub repo in owner/name form (e.g. vercel/next.js).

Required string length: 3 - 140
Example: