Brand monitoring

Brand monitoring finds the sentences where people compare, complain, and recommend, checks the brand's home community, and sweeps X for volume.

Recipe

1. No key needed to start: call every step below keyless, under a shared budget of 20 credits per IP per day. Running this daily needs more than that; buy a key at /upgrade first. It's shown once on the confirmation page.
2. reddit_search with type: "comments": run a few narrow queries for the brand name and its common nicknames or misspellings. There is no server-side time window on comment search, so filter results on created_at yourself. Cost: 6 credits per query page.
3. reddit_get_subreddit_posts with sort: "new": poll the brand's home community (or its category subreddit) for new posts. Cost: 4 credits per page.
4. x_search with type: "recent": sweep X for the same brand terms, the deep chronological mode. Cost: 6 credits per page.
5. get_usage: free, exempt from the rate limit, once you have a key. Check balance before a scheduled run.

Total cost

A daily sweep of 3 comment searches, 1 subreddit poll, and 1 X sweep: 28 credits/day.

Limits worth knowing

• Comment search has no time-window parameter; filter on created_at client-side and re-poll with sort: "new" for fresh mentions.
• Reddit's discover depth caps around a few hundred results per query; several narrow queries beat one broad one.
• Cached search results refresh on a 20-minute cycle: polling faster than that replays the same page.
• X search paginates as far as you follow the cursor, so a deep sweep costs linearly in pages; budget for that before running one.

Run it

Platform docs: /docs/reddit and /docs/x. Full reference: /docs.