Bulk Alerts Creation
KWatch allows you to create multiple alerts at once using a CSV file. This feature is particularly useful when you want to set up multiple alerts across different platforms quickly.
CSV File Format
Your CSV file should use commas as delimiters (","). The first row must contain the column headers, and each subsequent row represents one alert configuration.
Required Columns
| Column name | Type | Description |
|---|---|---|
| platform | string | The platform you want to monitor. Must be one of: "reddit", "hacker news", "twitter", "linkedin", "quora", "youtube", or "facebook". |
| keywords | string | The keywords you want to monitor. Each keyword can be made of one or several words. You can specify up to 3 independent keywords that should ALL appear in the result. Separate multiple keywords with commas. Example: chatgpt, blog article, seo |
Optional Columns
| Column name | Type | Description |
|---|---|---|
| excluded keywords | string | Keywords that should not appear in the results. You can specify up to 10 excluded keywords (5 for LinkedIn). Separate multiple keywords with commas. Example: spam, promotion, advertisement |
| included users | string | (Reddit, Hacker News, X (Twitter), and Youtube only) Only monitor content from these specific users. Up to 3 users maximum. Not case sensitive. Example: maxai834, thebloke, badenergy12x |
| excluded users | string | (Reddit, Hacker News, X (Twitter), and Youtube only) Do not monitor content from these users. Up to 3 users maximum. Not case sensitive. Example: maxai834, thebloke, badenergy12x |
| included subreddits | string | (Reddit only) Only monitor these specific subreddits. Up to 10 subreddits maximum. Not case sensitive, no 'r/' prefix. Example: marketing, saas, startups |
| excluded subreddits | string | (Reddit only) Do not monitor these subreddits. Up to 10 subreddits maximum. Not case sensitive, no 'r/' prefix. Example: marketing, saas, startups |
| public facebook group url | string | (Facebook only) The URL of the public Facebook group to monitor. Example: https://www.facebook.com/groups/1234567890/ |
| included languages | string | Only monitor content in these languages. Use ISO language codes. Up to 3 languages maximum. Example: en, fr, es |
| excluded languages | string | Do not monitor content in these languages. Use ISO language codes. Up to 3 languages maximum. Example: en, fr, es |
| whole words only | boolean | (Reddit, Hacker News, and X (Twitter) only) Only match complete words. For example, if you monitor "kwatch", it won't match "kwatch.io". Use "true" or "false". |
| case sensitive | boolean | (Reddit and Hacker News only) Match exact case. For example, if you monitor "kwatch", it won't match "KWatch". Use "true" or "false". |
| search posts | boolean | (Reddit, Hacker News, and X (Twitter) only) Monitor keywords in posts. Use "true" or "false". |
| search comments | boolean | (Reddit, Hacker News, and X (Twitter) only) Monitor keywords in comments. Use "true" or "false". |
| include nsfw | boolean | (Reddit only) Include NSFW content. Use "true" or "false". |
| enabled | boolean | Whether the alert should be active. Use "true" or "false". |
Examples
Basic Example
platform,keywords
reddit,chatgpt
twitter,ai tools
linkedin,digital marketing
Advanced Example
platform,keywords,excluded keywords,included users,excluded users,included subreddits,excluded subreddits,whole words only,case sensitive,search posts,search comments,include nsfw,enabled
reddit,chatgpt,spam,user1,user2,technology,news,true,false,true,true,false,true
twitter,ai tools,promotion,user3,user4,,,,true,true,false,,true
linkedin,digital marketing,advertisement,,,,,,,true,,,true
File Size Limit
The maximum file size for import is 10 MB. This should be more than enough for most use cases, as a typical CSV file with hundreds of keywords will be much smaller, but if you need to import a larger file, please contact us.
Import Process
- Prepare your CSV file following the format described above
- Go to the Bulk Import page in your KWatch dashboard
- Click "Choose File" and select your CSV file
- Optionally, enable "Override existing alerts" if you want to replace all your current alerts
- Click "Import file"
After the import is complete, you'll see a success message, and your new alerts will be immediately active.