Social Intelligence

Social Intelligence with x402 APIs

Access Reddit through x402-protected endpoints.

Setup

See rules/getting-started.md for installation and wallet setup.

Quick Reference

See rules/rate-limits.md for usage guidance.

Reddit

Search Posts

Search Reddit for posts:

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "best programming languages 2024"}'

Parameters:

• query - Search terms (required)
• subreddit - Limit to specific subreddit
• sort - relevance, hot, new, top
• time - hour, day, week, month, year, all

Returns:

• Post title and content
• Author and subreddit
• Upvotes and comment count
• Post URL

Search in Subreddit

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{
  "query": "typescript vs javascript",
  "subreddit": "programming",
  "sort": "top",
  "time": "year"
}'

Get Post Comments

Get comments from a Reddit post:

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/post-comments -m POST -b '{"postUrl": "https://reddit.com/r/programming/comments/abc123/..."}'

Returns:

• Comment text and author
• Upvotes/downvotes
• Reply threads
• Comment timestamps

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

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

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "competitor name review", "sort": "top", "time": "year"}'

Community Sentiment

• [ ] Identify relevant subreddit
• [ ] Search for discussions on topic
• [ ] Get comments from top posts
• [ ] Synthesize overall sentiment

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "new feature name", "subreddit": "relevant_community", "sort": "hot"}'

npx agentcash@latest fetch https://stableenrich.dev/api/reddit/post-comments -m POST -b '{"postUrl": "https://reddit.com/..."}'

Response Data

Reddit Post Fields

• title - Post title
• selftext - Post body (for text posts)
• author - Username
• subreddit - Subreddit name
• score - Upvotes minus downvotes
• numComments - Comment count
• url - Link to post
• createdUtc - Timestamp

Reddit Comment Fields

• body - Comment text
• author - Username
• score - Net upvotes
• replies - Nested replies
• createdUtc - Timestamp

Cost Estimation

Getting Started

Setup

1. Install the agentcash CLI:

   npm install -g agentcash

2. Check wallet:

   npx agentcash@latest balance

3. Fund wallet (if needed):

• Redeem invite: npx agentcash@latest redeem YOUR_CODE
• Or run npx agentcash@latest accounts to get Base or Solana deposit links and wallet addresses

Troubleshooting

Rate Limits and Usage Guidelines

General Guidelines

x402 endpoints don't have strict rate limits per se, but:

1. Respect platform norms - Don't spam searches 2. Space out requests - Avoid rapid-fire identical queries 3. Cache results - Don't re-fetch the same data repeatedly 4. Be specific - Targeted queries work better than broad ones

Reddit Considerations

Search Tips

• Subreddit filtering makes searches much more relevant
• Use sort="top" and time="year" for quality content
• "hot" gives current discussions

Comments

• Large threads may have truncated comments
• Focus on top-level comments for sentiment
• Deeply nested replies may not all be returned

What Works Well

• Subreddit-specific searches
• Top/hot post discovery
• Getting comment threads

What May Not Work

• Very old archived posts
• Deleted content
• Quarantined subreddits

Efficient Usage Patterns

Do This

# One targeted search (Reddit)
npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "specific topic", "subreddit": "relevant", "sort": "top"}'

Avoid This

# Multiple broad searches for same topic — wasteful
npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "AI"}'
npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "artificial intelligence"}'
npx agentcash@latest fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "machine learning"}'

Instead, craft one good query or search sequentially only when each result informs the next.

Cost Management

Reddit endpoints are $0.02 per call.

Budget for ~5-10 calls per monitoring session to cover Reddit search and comments.