Prowlo — Reddit & X for AI agents

Get your organization's product profile: name, description, audience, value propositions, tone, reply guidelines, confirmed discovery keywords, and competitors. Useful context for crafting relevant replies. (requires a free Prowlo account — call it to get a signup link)

Update your organization's product profile — the context get_product_profile returns and Prowlo's research and reply features build on. Partial patch: only the fields you pass change; arrays replace the stored list; nullable string fields accept null to clear. Owner/admin API keys only. Saving recomputes the product embedding. Not metered. (requires a free Prowlo account — call it to get a sig

List your org's TAGGING RULES (the dashboard's 'Tagging rules') — labels applied to posts your Watchers already ingest. NOT the dashboard's Keyword Monitor: for the keywords that search all of Reddit daily, use keyword_monitor_list. Each rule tags matching Dataset records whose title or body mentions its term as a whole word. Returns the term, active status, and match statistics. Changes take ef

[DEPRECATED — renamed tag_rule_list. Will be removed after 2026-10-07.] List your org's TAGGING RULES (the dashboard's 'Tagging rules') — labels applied to posts your Watchers already ingest. NOT the dashboard's Keyword Monitor: for the keywords that search all of Reddit daily, use keyword_monitor_list. Each rule tags matching Dataset records whose title or body mentions its term as a whole wo

Create TAGGING RULES (the dashboard's 'Tagging rules') — org-wide labels for posts your Watchers already ingest. This does NOT search Reddit: to add a Keyword Monitor entry that searches all of Reddit daily, use keyword_monitor_create instead. Each rule tags records across all your Watchers where the title or body mentions its term as a whole word — "f5bot" matches "f5bot." but not "f5bots". A

[DEPRECATED — renamed tag_rule_create. Will be removed after 2026-10-07.] Create TAGGING RULES (the dashboard's 'Tagging rules') — org-wide labels for posts your Watchers already ingest. This does NOT search Reddit: to add a Keyword Monitor entry that searches all of Reddit daily, use keyword_monitor_create instead. Each rule tags records across all your Watchers where the title or body mentio

Update a TAGGING RULE (dashboard: 'Tagging rules') — not a Keyword Monitor entry (those are Watchers; see watcher_update). Rename its term (pass `keyword`), set what it refers to (pass `description`), and/or pause/resume it (pass `active`). Renaming keeps already-tagged records on the old tag; new matches use the new term. Changes take effect on the next scheduled processing cycle. Existing oppo

[DEPRECATED — renamed tag_rule_update. Will be removed after 2026-10-07.] Update a TAGGING RULE (dashboard: 'Tagging rules') — not a Keyword Monitor entry (those are Watchers; see watcher_update). Rename its term (pass `keyword`), set what it refers to (pass `description`), and/or pause/resume it (pass `active`). Renaming keeps already-tagged records on the old tag; new matches use the new ter

Remove a TAGGING RULE (dashboard: 'Tagging rules') and stop it from tagging posts — not a Keyword Monitor entry (those are Watchers; see watcher_delete). This action cannot be undone. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)

[DEPRECATED — renamed tag_rule_delete. Will be removed after 2026-10-07.] Remove a TAGGING RULE (dashboard: 'Tagging rules') and stop it from tagging posts — not a Keyword Monitor entry (those are Watchers; see watcher_delete). This action cannot be undone. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requir

Add tags to ONE record in your Dataset — the same hand-applied tag the dashboard's "+ Tag" action writes. This tags only the record you name; it does NOT create a rule and has no effect on future posts — for "tag everything matching a term", use tag_rule_create instead. `id` is the record id returned by list_records / search_dataset / get_record (a source-item id), not a tagging-rule id. Manua

Live full-text search of a source. platform="reddit": params query, subreddit? (restrict), sort? (relevance/hot/new/top/comments), time?, limit≤20. platform="hackernews": params query, sort? (relevance/new), tags? (story/ask_hn/show_hn), minPoints?, author?, since? (unix), limit≤20. 1 credit · read-only. Reddit results come via RSS (score/comments may be 0). Long bodies are truncated; fetch a

List posts/stories. platform="reddit": REQUIRES channel (subreddit); sort? hot|new|top|rising|controversial; time? for top/controversial; limit≤20. platform="hackernews": sort carries the ranking top|new|best|ask|show|job (default top); channel ignored; limit≤30. 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)

Fetch one post/story with its comment thread. id: reddit permalink URL / t3_xxx / bare id; hackernews numeric item id. includeComments (default true), commentLimit≤20. 1 credit · read-only. Reddit comments via RSS are flat/unscored. (requires a free Prowlo account — call it to get a signup link)

Fetch a user profile. reddit: account age, karma, verified-email. hackernews: karma, about, created, submission count. 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)

Fetch a user's recent submissions or comments. kind=submissions|comments (default submissions). reddit via RSS (newest-first, ~20). 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)

Discover or inspect channels (Reddit subreddits) LIVE. Pass `query` to search, or an exact `channel` for its metadata (+ rules via include:["rules"]). Reddit only — hackernews has no channels. 1 credit · read-only. For cached stats, growth history, promo tolerance, and similar-community lists on the ~1,200 subs Prowlo already tracks, use catalog_search_subreddits / catalog_get_subreddit instead

List records in your Dataset (Prowlo’s indexed posts from crawled sources). NOT a live Reddit call — free, rate-limited only. Filter by view (all/matched), subreddits, platforms, tags, keyword, `any` (brand-variant OR-group), include/exclude, intent, score/comments, date range, watcherId. Paginated via cursor. Note: tags / watcherId are record-level, so passing either uses the "matched" view a

Semantic or keyword search across your Dataset (vector + full-text over your indexed corpus). NOT a live Reddit call — free, rate-limited only. Supports the full record filter: subreddits, platforms, `any` (brand-variant OR-group), include/exclude, intent, score/comments, date range, tags, watcherId. Records whose keyword match was AI-judged coincidental are hidden by default (pass includeSuppre

Fetch one Dataset record by id (full body + intent/embedding signals + tags). NOT a live Reddit call — free, rate-limited only. (requires a free Prowlo account — call it to get a signup link)

High-level summary of your Dataset: record count, last ingest time, number of watchers/sources, busiest channels, plus your daily live-read usage and reset time. NOT a live Reddit call — free, rate-limited only. Use this first to understand the size and shape of your archive before querying it. (requires a free Prowlo account — call it to get a signup link)

List the Watchers configured for your organization (the same ones the dashboard manages). Each Watcher shows its sources (platform + channel), paused state, tags (including ones set in the dashboard), record counts, and how many records arrived today. Watchers with platform "reddit_search" are the dashboard's Keyword Monitor entries — for those, the subreddit field holds the search query, not a

Read crawl-run activity: a summary (total runs, errored runs, new posts, matched, stored bytes) plus a paginated list of recent runs with per-run fetched/matched/new/duration and any error. NOT metered. (requires a free Prowlo account — call it to get a signup link)

Read recent OPERATIONAL alerts — Prowlo's own failures: errored crawl runs (critical) and failed webhook deliveries (warning), merged and time-sorted. NOT the user's configured Alerts: for those, use alert_list. NOT metered. (requires a free Prowlo account — call it to get a signup link)

(Legacy alias for get_operational_alerts.) Read recent OPERATIONAL alerts — Prowlo's own failures: errored crawl runs (critical) and failed webhook deliveries (warning), merged and time-sorted. NOT the user's configured Alerts: for those, use alert_list. NOT metered. (requires a free Prowlo account — call it to get a signup link)

Semantic + keyword search over Prowlo's own pre-crawled subreddit catalog (~1,200 tracked, active, non-NSFW communities) — NOT a live Reddit call and NOT your org's Dataset. The same index behind prowlo.com's public Subreddit Finder. Use this FIRST when discovering candidate communities for a product or niche; describe the audience or problem, not just keywords. Returns ranked cards with subscri

One subreddit's card from Prowlo's tracked catalog — NOT a live Reddit call. view="stats" (default): subscribers, posts/day, comments/post, postsPerDay is sampled from the subreddit's own newest-100 /new feed (postsPerDaySpanHours = the real span those posts cover; postsPerDaySampleSize; null = not sampled in the last 14 days or fewer than 10 posts), plus activeUsers (online now at the last snap

Ranked lists from Prowlo's tracked catalog — NOT a live Reddit call. metric: largest (subscribers), most-active (posts/day sampled from each sub's own /new feed within the last 14 days; unsampled subs sort last), fastest-growing (30-day % — needs ≥30 days of snapshot history; until enough exists the response is available:false with trackingSince — a SUCCESS shape, don't retry; size=all app

List your organization’s Alerts (persistent rules that fire to Slack/webhooks when records match). Includes last-delivered time and total deliveries. Not metered. (requires a free Prowlo account — call it to get a signup link)

Create an Alert. It fires when newly-ingested records match `query`. REQUIRED: `query.any` must have at least one mention term (brand/product/domain) — an alert with no mentions would match every record and is rejected. Per-match by default (one notification per new match, batched); provide `threshold` for volume/spike firing. Delivers to Slack and/or the given webhooks. Not metered. (requires a

Update an Alert (name, query, destination, threshold, or status). Only provided fields change. If `query` is provided it must still include at least one `query.any` mention term. Not metered. (requires a free Prowlo account — call it to get a signup link)

Delete an Alert by id. Not metered. (requires a free Prowlo account — call it to get a signup link)

List recent deliveries (fires) for one Alert — what was matched and where it was sent. Not metered. (requires a free Prowlo account — call it to get a signup link)

List your organization’s Trends (saved queries that produce a time-series, e.g. brand-mention counts over time). Includes computed point counts. Points are sparse: only interval buckets with at least one matching record are stored, so pointCount can be far below window÷interval — a 30d daily trend with matches on one day has pointCount 1. Not metered. (requires a free Prowlo account — call

Get one Trend with its computed time-series points (count + per-intent breakdown per interval bucket). Points are sparse: interval buckets with zero matches are omitted, not stored as 0 — treat missing buckets as zero when charting. Not metered. (requires a free Prowlo account — call it to get a signup link)

Create a Trend: a saved match query bucketed over time. `interval` is "hour" or "day"; `window` is how far back to compute (e.g. "30d"). Points recompute periodically. Not metered. (requires a free Prowlo account — call it to get a signup link)

Update a Trend (name, query, interval, or window). Only provided fields change. Not metered. (requires a free Prowlo account — call it to get a signup link)

Delete a Trend by id. Not metered. (requires a free Prowlo account — call it to get a signup link)

Get your daily live-read usage: today's passthrough count, your daily cap, and reset time. Live-Reddit reads (social_search, social_list_posts, social_get_post, social_get_user, social_get_user_activity, social_find_channels) count toward a daily cap, charged on success. research_run draws from the AI-credit pool (first run per org free; later runs use credits — the balance is in aiCredits). Int

Get your Prowlo account details: organization ID + name, your user ID, email, role, plan, account status, and integration state (connected Slack channels, webhook endpoints). Check `integrations` before setting an Alert destination — `destination.slack` only delivers if Slack is connected, and `destination.webhookIds` must reference the webhook ids listed here. Use this to identify your account

Create Watchers — including KEYWORD MONITOR entries (the dashboard's "Keywords" page): pass platform "reddit_search" with the search query as `channel`; each searches all of Reddit daily and draws from its own per-plan keyword limit (keyword_monitor_create is the one-query shortcut). Community watchers (a subreddit or HN feed) are the default platform. A Watcher watches exactly ONE community/que

Pause/resume a Watcher and/or replace its tags. (Names are derived from the source and cannot be changed.) `tags` replaces the Watcher's plain tags — tags added by conditional tagging rules in the dashboard are unaffected. Not metered. (requires a free Prowlo account — call it to get a signup link)

Delete a Watcher by id (also removes its source and records). Not metered. (requires a free Prowlo account — call it to get a signup link)

Deprecated: a Watcher watches exactly one community/query. Use watcher_create to watch another community (one Watcher is created per source). Not metered. (requires a free Prowlo account — call it to get a signup link)

Remove a source from a Watcher by source id. (A source-less Watcher ingests nothing — usually you want watcher_delete.) Not metered. (requires a free Prowlo account — call it to get a signup link)

List your Keyword Monitor entries (the dashboard's "Keywords" page): each searches all of Reddit once a day for its query and ingests matches into your Dataset. Returns your keyword quota (used/max; max -1 = unlimited). Add via keyword_monitor_create; pause via watcher_update; delete via watcher_delete (ids are Watcher ids). NOT the tagging rules — see tag_rule_list. Not a live Reddit call — f

Add a Keyword Monitor entry — searches all of Reddit daily for this query and ingests matches into your Dataset. This is the tool for "track keyword X on Reddit". Draws from your plan's keyword limit (see keyword_monitor_list). Creates a Watcher with platform "reddit_search" under the hood, so watcher_update/watcher_delete manage it afterwards. Not metered. (requires a free Prowlo account — ca

Read the latest Community research report for a product (or a specific runId), or its progress while running. `section` = summary (default: brief, highlights, tiers, evidence counts, other runs) | communities (paginated by `tier`) | content | competitors | voice | plan (threads carry live score/comments/removed state when available) | markdown. Read this BEFORE recommending subreddits or drafting

Rewrite YOUR drafted comment so it reads like a real person typed it, not an AI: strips AI tells, compresses to the 1-2 points that matter, varies rhythm, and lightly "dirties" it (lowercase sentence starts, no markdown). Best AFTER you draft a reply — write the real substance, then humanize it. INPUT RULES for best results: (1) put every fact/number/name you want kept IN the text — it never i