Social Intelligence

Social Intelligence with x402 APIs

STOP — Read before making any API call. enrichx402.com endpoints are not the same as each provider's native API. All paths use the format https://enrichx402.com/api/{provider}/{action}. You MUST either:

1. Copy exact URLs from the Quick Reference table below, OR

2. Run x402.discover_api_endpoints(url="https://enrichx402.com") to get the correct paths

>

Guessing paths will fail with 405 errors (wrong path) or 404 errors (missing /api/ prefix).

Access X/Twitter (via Grok) and 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.

X/Twitter via Grok

Search Posts

Search for X posts by keywords:

x402.fetch(
  url="https://enrichx402.com/api/grok/x-search",
  method="POST",
  body={
    "query": "AI agents"
  }
)

Parameters:

• query - Search keywords (required)

Returns:

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

Search Users

Find X users matching criteria:

x402.fetch(
  url="https://enrichx402.com/api/grok/user-search",
  method="POST",
  body={
    "query": "AI researcher San Francisco"
  }
)

Returns:

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

Get User's Posts

Fetch recent posts from a specific user:

x402.fetch(
  url="https://enrichx402.com/api/grok/user-posts",
  method="POST",
  body={
    "username": "elonmusk"
  }
)

Parameters:

• username - X username without @ (required)

Returns: Recent posts with full engagement metrics.

Reddit

Search Posts

Search Reddit for posts:

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={
    "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

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={
    "query": "typescript vs javascript",
    "subreddit": "programming",
    "sort": "top",
    "time": "year"
  }
)

Get Post Comments

Get comments from a Reddit post:

x402.fetch(
  url="https://enrichx402.com/api/reddit/post-comments",
  method="POST",
  body={
    "postUrl": "https://reddit.com/r/programming/comments/abc123/..."
  }
)

Returns:

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

Workflows

Standard

1. (Optional) Check balance: x402.get_wallet_info 2. Discover endpoints (required before first fetch): x402.discover_api_endpoints(url="https://enrichx402.com") 3. Check endpoint schema: x402.check_endpoint_schema(url="...") to verify parameters and pricing 4. Call endpoint with x402.fetch using exact URL from discovery or Quick Reference table above 5. Parse and present results

Brand Monitoring

• [ ] (Optional) Check balance: x402.get_wallet_info
• [ ] Search X for brand mentions
• [ ] Search Reddit for discussions
• [ ] Summarize sentiment and key mentions

x402.fetch(
  url="https://enrichx402.com/api/grok/x-search",
  method="POST",
  body={"query": "YourBrand OR @YourBrand"}
)

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"query": "YourBrand", "sort": "new"}
)

Competitor Research

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

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"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

x402.fetch(
  url="https://enrichx402.com/api/grok/user-search",
  method="POST",
  body={"query": "tech blogger 100k followers"}
)

Community Sentiment

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

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"query": "new feature name", "subreddit": "relevant_community", "sort": "hot"}
)

x402.fetch(
  url="https://enrichx402.com/api/reddit/post-comments",
  method="POST",
  body={"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

Getting Started

Setup

1. Install the x402scan MCP:

   npx @x402scan/mcp install --client claude-code -y

2. Check wallet:

   x402.get_wallet_info

3. Fund wallet (if needed):

• Redeem invite: x402.redeem_invite(code="YOUR_CODE")
• Or use the deposit UI (point the user towards this URL: https://x402scan.com/mcp/deposit/<their-wallet-address>)

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

X/Twitter (Grok) Considerations

Search Tips

• Use specific keywords, not generic terms
• Include usernames with @ for targeted search
• Combine terms: "AI agents" works better than just "AI"

User Posts

• User posts are relatively stable
• Don't fetch the same user repeatedly in short timeframes
• Consider summarizing after one fetch rather than re-fetching

What Works Well

• Keyword searches for topics
• Finding users by description
• Getting recent activity for specific accounts

What May Not Work

• Historical searches far in the past
• Very high-volume accounts (may be truncated)
• Protected/private accounts

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
x402.fetch(
  url=".../reddit/search",
  body={"query": "specific topic", "subreddit": "relevant", "sort": "top"}
)

Avoid This

# Multiple broad searches for same topic
x402.fetch(body={"query": "AI"})
x402.fetch(body={"query": "artificial intelligence"})
x402.fetch(body={"query": "machine learning"})

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

Cost Management

All social intelligence endpoints are $0.02 per call.

Budget for ~10 calls per monitoring session to cover X search, user lookup, Reddit search, and comments.