polymerdao/polymer-pay-clawapi-x

ClawAPI X

Access X/Twitter data through ClawAPIs — search tweets, lookup users, browse timelines, explore communities, and manage interactions. Each request is paid individually through the Polymer Pay proxy with no X API key or developer account required.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/clawapis.com

Common Operations

Search Tweets

Search recent tweets with keywords, phrases, hashtags, and filters.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/tweets/search/recent?query=bitcoin&lang=en&max_results=10",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: Array of tweet objects with text, author info, engagement metrics (likes, retweets, replies), and timestamps.

Get User Profile

Fetch a public X/Twitter profile by username with bio and metrics.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/users/by/username/elonmusk?user.fields=description,public_metrics",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON object with display name, username, bio, follower count, following count, tweet count, and profile image URL.

Get Tweet

Retrieve a single tweet by ID with full content and engagement data.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/tweets/123456789",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON object with tweet text, author details, engagement metrics (likes, retweets, replies, views), timestamp, and media attachments.

Get User Tweets

Fetch recent tweets from a specific user's timeline.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/users/123456789/tweets?max_results=10",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: Array of recent tweets with text, engagement metrics, and timestamps. Use pagination_token to fetch older tweets.

Get User Followers

Get a list of users who follow a specific account.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/users/123456789/followers?max_results=100",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: Array of user objects with profile data and pagination token for more results.

Post Tweet (OAuth Required)

Post a new tweet. Requires OAuth2 authentication via X-Session-Id or X-User-Token header.

Pricing: $0.05

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/clawapis.com/x/2/tweets",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}",
    "X-Session-Id": "YOUR_OAUTH_SESSION_ID"
  },
  "body": {
    "text": "Hello from my agent!"
  }
}

Response: Posted tweet object with ID and text.

Search Query Parameters

The /x/2/tweets/search/recent endpoint supports these query parameters:

| Parameter | Description | |-----------------|--------------------------------------------------| | query | Search query (keywords, phrases, operators) | | max_results | Number of tweets to return (10-100) | | start_time | Start date (ISO 8601) | | end_time | End date (ISO 8601) | | tweet.fields | Fields to include (created_at,author_id,etc) | | user.fields | User fields to include (public_metrics,etc) | | next_token | Pagination token for next page |

Search Operators:

• from:username — Tweets from specific user
• to:username — Tweets mentioning specific user
• #hashtag — Filter by hashtag
• "exact phrase" — Exact phrase match
• -keyword — Exclude keyword

When to Use

• Real-time tweet search — Find tweets about topics, tokens, or events with advanced query operators
• User profile lookup — Get public profile info, follower counts, and bio data
• Timeline monitoring — Track what specific accounts are posting
• Social media research — Analyze tweet engagement and user metrics
• Content discovery — Find tweets by keywords, hashtags, or date ranges
• Community management — Monitor mentions, replies, and follower growth
• AI agent integration — Give agents autonomous access to X/Twitter data at predictable per-call cost

Best Practices

• Use search operators — Combine from:, #hashtag, "phrases" for precise results
• Paginate with next_token — All list endpoints return a token for fetching more results
• Filter by fields — Use tweet.fields and user.fields to get only the data you need
• Cache user profiles — Profile data doesn't change frequently; cache to reduce costs
• OAuth for writes — Reading public data needs no auth; posting/liking requires OAuth session
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting