> ## Documentation Index > Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Choose a Watchlist Type > The four watchlist types (LinkedIn keyword, Reddit, people, company), which endpoint creates each, and how to track one topic on both LinkedIn and Reddit. A watchlist is a saved monitoring job that continuously collects posts. **Each watchlist tracks exactly one platform and one tracking mode, and each type has its own endpoint.** There is no generic "create watchlist" call and no single call that spans two platforms. ## The four types | Type | Platform | Tracks | Endpoint | Required create field | Prompt mode | Intent labels | Default fetch frequency | | ------- | ------------ | ------------------------------------ | ------------------------ | ---------------------- | ----------- | ------------- | ----------------------- | | Keyword | **LinkedIn** | Posts matching keywords | `/api-keyword-watchlist` | `keywords` or `prompt` | Yes | Yes | 12h | | Reddit | **Reddit** | Posts and comments matching keywords | `/api-reddit-watchlist` | `keywords` or `prompt` | Yes | Yes | 24h | | People | **LinkedIn** | Posts from specific profiles | `/api-people-watchlist` | `profiles` | No | No | Managed by OutX | | Company | **LinkedIn** | Posts from company pages | `/api-company-watchlist` | `companies` | No | No | Managed by OutX | All four types share one CRUD pattern (POST create, GET read, PUT update, DELETE delete on the same URL) and all four count toward the **same** plan watchlist limit (a `402` error names your limit; check remaining quota first with [`GET /api-team`](/docs/api-reference/team/get)). Posts collected by any watchlist type are read from the same endpoint: [`GET /api-posts?watchlist_id=...`](/docs/api-reference/engagement/posts/get). The response shape adapts automatically to the watchlist's platform. ## Task-to-endpoint map | You want to | Call | | -------------------------------- | -------------------------------------------------------------------------------------- | | Track a topic on LinkedIn | `POST /api-keyword-watchlist` with `prompt` (or `keywords`) | | Track the same topic on Reddit | `POST /api-reddit-watchlist` with `prompt` (or `keywords`), a **separate second call** | | Track specific LinkedIn people | `POST /api-people-watchlist` with `profiles` | | Track LinkedIn company pages | `POST /api-company-watchlist` with `companies` | | Read collected posts (any type) | `GET /api-posts?watchlist_id=...` | | List watchlists of a type | `GET /api--watchlist` (each endpoint lists only its own type) | | Change keywords or intent labels | `PUT /api-keyword-watchlist` or `PUT /api-reddit-watchlist` | | Pause or resume collection | `PUT` on the type's endpoint with `disable: true` or `false` | **"LinkedIn and Reddit" means two watchlists.** A request like "monitor AI CRM tools on LinkedIn and Reddit" is two API calls: one `POST /api-keyword-watchlist` and one `POST /api-reddit-watchlist`. They return different watchlist IDs, run on independent fetch cycles, and their feeds are read separately. ## Recipe: one topic on LinkedIn and Reddit Send the same `prompt` to both endpoints. OutX generates platform-appropriate keywords and intent labels for each in the background. ```bash theme={null} # 1. LinkedIn keyword watchlist curl -X POST "https://api.outx.ai/api-keyword-watchlist" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "prompt": "Companies evaluating AI-native CRM tools and alternatives to Salesforce", "name": "AI CRM - LinkedIn" }' # 2. Reddit watchlist (same prompt, different endpoint) curl -X POST "https://api.outx.ai/api-reddit-watchlist" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "prompt": "Companies evaluating AI-native CRM tools and alternatives to Salesforce", "name": "AI CRM - Reddit" }' ``` Each call returns `201` with its own `id`. Save both. To read the feeds: ```bash theme={null} curl "https://api.outx.ai/api-posts?watchlist_id=LINKEDIN_WATCHLIST_ID" -H "x-api-key: YOUR_API_KEY" curl "https://api.outx.ai/api-posts?watchlist_id=REDDIT_WATCHLIST_ID" -H "x-api-key: YOUR_API_KEY" ``` There is no cross-watchlist feed endpoint; merge the two result sets client-side if you need a combined view. ## Differences that matter to an agent * **Keyword and Reddit watchlists are twins.** Same body shape on create and update (`keywords`, `prompt`, `labels`, `fetchFreqInHours`, `slack_webhook_url`, `append`), same [intent label](/docs/api-reference/concepts/intent-labels) system. Only the platform, the endpoint, and the default fetch frequency (12h vs 24h) differ. * **People and company watchlists have no Reddit equivalent** and no keywords, prompts, or intent labels. They track a fixed set of profiles or company pages. * **Collection runs through the OutX Chrome extension.** For every watchlist type, at least one team member must have the extension installed and active (it must have checked in within the last 48 hours); otherwise API requests return `403 Plugin installation required`. * **Only the keyword (LinkedIn) type backfills on create.** A new LinkedIn keyword watchlist backfills recent matching posts automatically, so it is usually non-empty within minutes. Reddit, people, and company watchlists start filling on their first fetch cycle. ## Next steps LinkedIn keyword tracking, direct or prompt mode The Reddit twin of the keyword watchlist How posts get classified and what default labels do Read and filter any watchlist's feed