Social Intelligence with x402 APIs

Setup

Quick Reference

https://stableenrich.dev/api/grok/x-search

https://stableenrich.dev/api/grok/user-search

https://stableenrich.dev/api/grok/user-posts

https://stableenrich.dev/api/reddit/search

https://stableenrich.dev/api/reddit/post-comments

X/Twitter via Grok

Search Posts

npx agentcash fetch https://stableenrich.dev/api/grok/x-search -m POST -b '{"query": "AI agents"}'

• query

  - Search keywords (required)

• Post text and author info
• Engagement metrics (likes, retweets, replies)
• Timestamps and URLs
• Media attachments

Search Users

npx agentcash fetch https://stableenrich.dev/api/grok/user-search -m POST -b '{"query": "AI researcher San Francisco"}'

• Username and display name
• Bio/description
• Follower/following counts
• Verification status
• Profile links

Get User's Posts

npx agentcash fetch https://stableenrich.dev/api/grok/user-posts -m POST -b '{"username": "elonmusk"}'

• username

  - X username without @ (required)

Reddit

Search Posts

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

• query

  - Search terms (required)

• subreddit

  - Limit to specific subreddit

• sort

  - relevance, hot, new, top

• time

  - hour, day, week, month, year, all

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

Search in Subreddit

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

Get Post Comments

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

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

Workflows

Standard

• (Optional) Check balance:

  npx agentcash wallet info

• Use

  npx agentcash discover https://stableenrich.dev

  to list all endpoints
• Use

  npx agentcash check <endpoint-url>

  to see expected parameters and pricing
• Call endpoint with

  npx agentcash fetch

• Parse and present results

Brand Monitoring

• (Optional) Check balance:

  npx agentcash wallet info

• Search X for brand mentions
• Search Reddit for discussions
• Summarize sentiment and key mentions

npx agentcash fetch https://stableenrich.dev/api/grok/x-search -m POST -b '{"query": "YourBrand OR @YourBrand"}'

npx agentcash fetch https://stableenrich.dev/api/reddit/search -m POST -b '{"query": "YourBrand", "sort": "new"}'

Competitor Research

• Search Reddit for competitor reviews
• Search X for competitor mentions
• Analyze common complaints and praise

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

Influencer Discovery

• Define criteria (topic, follower range)
• Search for matching users
• Get recent posts for top candidates

npx agentcash fetch https://stableenrich.dev/api/grok/user-search -m POST -b '{"query": "tech blogger 100k followers"}'

Community Sentiment

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

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

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

Response Data

X/Twitter Post Fields

• text

  - Post content

• author

  - Username, display name, verified status

• metrics

  - Likes, retweets, replies, quotes, views

• createdAt

  - Timestamp

• url

  - Link to post

• media

  - Attached images/videos

X/Twitter User Fields

• username

  - Handle without @

• displayName

  - Full name

• description

  - Bio

• followers

  /

  following

  - Counts

• verified

  - Verification status

• profileImageUrl

  - Avatar

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