Social Intelligence with x402 APIs Skill

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:

Copy exact URLs from the Quick Reference table below, OR

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

| Task | Endpoint | Price | Description | |------|----------|-------|-------------| | Search X posts | https://enrichx402.com/api/grok/x-search | $0.02 | Search tweets by keywords | | Find X users | https://enrichx402.com/api/grok/user-search | $0.02 | Search users by criteria | | Get user posts | https://enrichx402.com/api/grok/user-posts | $0.02 | Recent posts from user | | Search Reddit | https://enrichx402.com/api/reddit/search | $0.02 | Search Reddit posts | | Get comments | https://enrichx402.com/api/reddit/post-comments | $0.02 | Comments on a post |

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.

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

(Optional) Check balance: x402.get_wallet_info
Discover endpoints (required before first fetch): x402.discover_api_endpoints(url="https://enrichx402.com")
Check endpoint schema: x402.check_endpoint_schema(url="...") to verify parameters and pricing
Call endpoint with x402.fetch using exact URL from discovery or Quick Reference table above
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

| Task | Calls | Cost | |------|-------|------| | Quick X search | 1 | $0.02 | | User profile + posts | 2 | $0.04 | | Reddit thread + comments | 2 | $0.04 | | Full monitoring scan | 4-6 | $0.08-0.12 |

Agent Skills: Social Intelligence with x402 APIs

Install this agent skill to your local

Skill Files