Skip to main content
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

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). Posts collected by any watchlist type are read from the same endpoint: GET /api-posts?watchlist_id=.... The response shape adapts automatically to the watchlist’s platform.

​
Task-to-endpoint map

“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.
Each call returns 201 with its own id. Save both. To read the feeds:
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 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

Create Keyword Watchlist

LinkedIn keyword tracking, direct or prompt mode

Create Reddit Watchlist

The Reddit twin of the keyword watchlist

Intent Labels Explained

How posts get classified and what default labels do

Get Posts

Read and filter any watchlist’s feed