Recommend monitoring settings from search history
Turns the workspace’s actual search history into recommended monitoring settings: a ranked keyword set (with rationale and evidence), platform recommendations, and relevance-guideline hints — capped at the target plan’s keyword allowance. Workspaces with little or no search history fall back to company-profile-derived suggestions (source: "domain"); the set is never empty.
Authorizations
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.
Query Parameters
Plan the user is upgrading to (default Starter_v3, the entry paid tier). Plans without keyword monitoring (e.g. Agents) are rejected with TARGET_PLAN_HAS_NO_KEYWORDS.
Individual, Start_up, Scale_up, AppSumoTier1, AppSumoTier2, AppSumoTier3, Free_trial, Basic, Pro, Max, Starter, Scale, Pro_v2, Enterprise, Starter_v3, Pro_v3, Agency, Agents "Starter_v3"
Response
200 response
Recommended monitoring settings (keywords, platforms, relevance-guideline hints) derived from the workspace's search history, sized for the target plan.
search_history when derived from the org's actual searches; domain when the history was too thin (or the model unavailable) and the company-profile fallback path answered.
search_history, domain The plan the recommendations are sized for — keyword recommendations are capped at that plan's monthly keyword allowance.
Individual, Start_up, Scale_up, AppSumoTier1, AppSumoTier2, AppSumoTier3, Free_trial, Basic, Pro, Max, Starter, Scale, Pro_v2, Enterprise, Starter_v3, Pro_v3, Agency, Agents "Starter_v3"
The target plan's monthly keyword allowance the set was capped to.
-9007199254740991 <= x <= 9007199254740991Ranked best-first. Never empty; never longer than keywordLimit.
Recommended platforms to monitor, best-first.
Platform a mention can originate from / a keyword can be monitored on.
dev, github, hackernews, linkedin, producthunt, reddit, stackoverflow, twitter, youtube, tiktok, medium, reddit_comment, bluesky, newsletter, podcasts, news, firehose Candidate org-specific relevance guidelines distilled from search contexts. May be empty.
What the recommendation was computed from.
