social-intelligence

# Social Intelligence with x402 APIs Access Reddit through x402-protected endpoints. ## Setup See [rules/getting-started.md](rules/getting-started.md) for installation and wallet setup. ## Quick Reference | Task | Endpoint | Price | Description | |------|----------|-------|-------------| | Search Reddit | `https://stableenrich.dev/api/reddit/search` | $0.02 | Search Reddit posts | | Get comments | `https://stableenrich.dev/api/reddit/post-comments` | $0.02 | Comments on a post | See [rules/rate-limits.md](rules/rate-limits.md) for usage guidance. ## Reddit ### Search Posts Search Reddit for posts: ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "best programming languages 2024"}' ``` **Parameters:** - `query` - Search terms (required). Scope to a subreddit with Reddit's `subreddit:` operator inside the query (there is no separate subreddit field) - `sort` - relevance, new, top, comment_count (default: relevance) - `timeframe` - all, day, week, month, year (default: all) - `maxResults` - Maximum results, 1-25 (default: 10) - `after` - Pagination cursor from a previous response **Returns:** - Post title and content - Author and subreddit - Upvotes and comment count - Post URL ### Search in Subreddit ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{ "query": "typescript vs javascript subreddit:programming", "sort": "top", "timeframe": "year" }' ``` ### Get Post Comments Get comments from a Reddit post: ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/post-comments -m POST -b '{"url": "https://reddit.com/r/programming/comments/abc123/..."}' ``` **Parameters:** - `url` - Full Reddit post URL (required) - `cursor` - Pagination cursor for more comments **Returns:** - Post details - Comment text and author - Comment scores - Comment timestamps - `hasMore` / `cursor` for pagination ## Workflows ### Standard - [ ] (Optional) Check balance: `npx agentcash@latest balance` - [ ] Use `npx agentcash@latest discover https://stableenrich.dev` to list endpoints - [ ] Use `npx agentcash@latest check <endpoint-url>` to see expected parameters and pricing - [ ] Call endpoint with `npx agentcash@latest fetch` - [ ] Parse and present results ### Brand Monitoring - [ ] (Optional) Check balance: `npx agentcash@latest balance` - [ ] Search Reddit for discussions - [ ] Summarize sentiment and key mentions ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "YourBrand", "sort": "new"}' ``` ### Competitor Research - [ ] Search Reddit for competitor reviews - [ ] Analyze common complaints and praise ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "competitor name review", "sort": "top", "timeframe": "year"}' ``` ### Community Sentiment - [ ] Identify relevant subreddit - [ ] Search for discussions on topic - [ ] Get comments from top posts - [ ] Synthesize overall sentiment ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "new feature name subreddit:relevant_community", "sort": "top"}' ``` ```bash npx agentcash@latest fetch https://stableenrich.dev/api/reddit/post-comments -m POST -b '{"url": "https://reddit.com/..."}' ``` ## Response Data ### Reddit Post Fields - `title` - Post title - `selftext` - Post body (for text posts; `selftextTruncated` flags truncation) - `author` - Username - `subreddit` - Subreddit name - `score` - Upvotes minus downvotes - `numComments` - Comment count - `permalink` - Link to post - `createdAt` - Timestamp Search responses also include `after` (pagination cursor) and `searchContext` (query + result count). ### Reddit Comment Fields - `body` - Comment text (`bodyTruncated` flags truncation) - `author` - Username - `score` - Net upvotes - `createdAt` - Timestamp Comments are returned as a flat list; use `hasMore` and `cursor` to page through more. ## Cost Estimation | Task | Calls | Cost | |------|-------|------| | Reddit thread + comments | 2 | $0.04 | | Full monitoring scan | 3-5 | $0.06-0.10 |