← APIs / x402.twit.sh
Verified

x402.twit.sh

Coinbase Bazaarby Coinbase Bazaar · marketplace

Pay-per-call x402 service at x402.twit.sh, listed in the Coinbase Bazaar. Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON.

datafederated
Price per request
$0.01
Base URL
https://gateway.apiosk.com/cbz-x402-twit-sh
Technical Specs
Auth MethodNone (x402 payment proof only)
Response FormatJSON
Endpoints11
Endpoints
MethodPathDescriptionCost
GET /lists/tweets Get the latest tweets from a Twitter/X List by its numeric List ID. Returns ~100 tweets per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/tweets?id=84839422. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /tweets Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /tweets/by/id Look up a single Twitter/X tweet by its numeric tweet ID. Returns full tweet data including text, author profile, creation date, engagement metrics (likes, retweets, replies, quotes, bookmarks), and referenced tweets. Query param: id (string, required) - numeric tweet ID, e.g. GET /tweets/by/id?id=1110302988. Returns X v2 API-compatible JSON.
$0.0029 default
View details
GET /tweets/quote_tweets Get a list of tweets that quote a specific tweet. Returns paginated quote tweets with author profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/quote_tweets?id=1110302988. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /tweets/replies Get replies to a specific Twitter/X tweet. Returns paginated reply tweets for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/replies?id=1110302988. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /tweets/retweeted_by Get the list of Twitter/X users who reposted a specific tweet. Returns paginated user profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/retweeted_by?id=1110302988. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /tweets/search Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON.
$0.0069 default
View details
GET /tweets/user Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /users/by/username Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON.
$0.0057 default
View details
GET /users/followers Get the list of Twitter/X users who follow a specific user. Returns up to 50 follower profiles per page with pagination support. Query params: id (string, required) - numeric Twitter user ID; next_token (string, optional) - pagination cursor, e.g. GET /users/followers?id=44196397. Returns X v2 API-compatible JSON.
$0.01 default
View details
GET /users/search Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON.
$0.01 default
View details
Endpoint documentation
GET/lists/tweets
$0.01 default
Description

Get the latest tweets from a Twitter/X List by its numeric List ID. Returns ~100 tweets per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/tweets?id=84839422. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric Twitter/X List ID",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/tweets
$0.01 default
Description

Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "ids": {
      "description": "Comma-separated numeric tweet IDs, max 50",
      "type": "string"
    }
  },
  "required": [
    "ids"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ]
}
GET/tweets/by/id
$0.0029 default
Description

Look up a single Twitter/X tweet by its numeric tweet ID. Returns full tweet data including text, author profile, creation date, engagement metrics (likes, retweets, replies, quotes, bookmarks), and referenced tweets. Query param: id (string, required) - numeric tweet ID, e.g. GET /tweets/by/id?id=1110302988. Returns X v2 API-compatible JSON.

Pricing
$0.0029 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric tweet ID",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": {
    "author": {
      "id": "9253672",
      "name": "Hal Finney",
      "username": "halfin"
    },
    "created_at": "2009-01-11T03:39:18.000Z",
    "id": "1110302988",
    "public_metrics": {
      "like_count": 134000,
      "quote_count": 3500,
      "reply_count": 5400,
      "retweet_count": 32000
    },
    "text": "Running bitcoin"
  }
}
GET/tweets/quote_tweets
$0.01 default
Description

Get a list of tweets that quote a specific tweet. Returns paginated quote tweets with author profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/quote_tweets?id=1110302988. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric tweet ID",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/tweets/replies
$0.01 default
Description

Get replies to a specific Twitter/X tweet. Returns paginated reply tweets for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/replies?id=1110302988. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric tweet ID",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/tweets/retweeted_by
$0.01 default
Description

Get the list of Twitter/X users who reposted a specific tweet. Returns paginated user profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/retweeted_by?id=1110302988. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric tweet ID",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "description": "Running bitcoin.",
      "id": "9253672",
      "name": "Hal Finney",
      "public_metrics": {
        "followers_count": 134000,
        "following_count": 200,
        "like_count": 300,
        "tweet_count": 600
      },
      "username": "halfin",
      "verified": false
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/tweets/search
$0.0069 default
Description

Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON.

Pricing
$0.0069 default
Parameters
{
  "properties": {
    "anyWords": {
      "description": "Any of these words",
      "type": "string"
    },
    "from": {
      "description": "Tweets from this username",
      "type": "string"
    },
    "hashtags": {
      "description": "Filter by hashtag",
      "type": "string"
    },
    "mentioning": {
      "description": "Tweets mentioning this username",
      "type": "string"
    },
    "minLikes": {
      "description": "Minimum like count",
      "type": "string"
    },
    "minReplies": {
      "description": "Minimum reply count",
      "type": "string"
    },
    "minReposts": {
      "description": "Minimum retweet count",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor",
      "type": "string"
    },
    "noneWords": {
      "description": "Exclude these words",
      "type": "string"
    },
    "phrase": {
      "description": "Exact phrase match",
      "type": "string"
    },
    "since": {
      "description": "Start date (YYYY-MM-DD)",
      "type": "string"
    },
    "to": {
      "description": "Tweets replying to this username",
      "type": "string"
    },
    "until": {
      "description": "End date (YYYY-MM-DD)",
      "type": "string"
    },
    "words": {
      "description": "All these words must appear",
      "type": "string"
    }
  },
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/tweets/user
$0.01 default
Description

Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    },
    "username": {
      "description": "Twitter screen name (without @)",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "author": {
        "id": "9253672",
        "name": "Hal Finney",
        "username": "halfin"
      },
      "created_at": "2009-01-11T03:39:18.000Z",
      "id": "1110302988",
      "public_metrics": {
        "like_count": 134000,
        "quote_count": 3500,
        "reply_count": 5400,
        "retweet_count": 32000
      },
      "text": "Running bitcoin"
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/users/by/username
$0.0057 default
Description

Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON.

Pricing
$0.0057 default
Parameters
{
  "properties": {
    "username": {
      "description": "Twitter screen name without @",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "type": "object"
}
Example response
{
  "data": {
    "description": "Running bitcoin.",
    "id": "9253672",
    "name": "Hal Finney",
    "public_metrics": {
      "followers_count": 134000,
      "following_count": 200,
      "like_count": 300,
      "tweet_count": 600
    },
    "username": "halfin",
    "verified": false
  }
}
GET/users/followers
$0.01 default
Description

Get the list of Twitter/X users who follow a specific user. Returns up to 50 follower profiles per page with pagination support. Query params: id (string, required) - numeric Twitter user ID; next_token (string, optional) - pagination cursor, e.g. GET /users/followers?id=44196397. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "id": {
      "description": "Numeric Twitter user ID",
      "type": "string"
    },
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "description": "Running bitcoin.",
      "id": "9253672",
      "name": "Hal Finney",
      "public_metrics": {
        "followers_count": 134000,
        "following_count": 200,
        "like_count": 300,
        "tweet_count": 600
      },
      "username": "halfin",
      "verified": false
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}
GET/users/search
$0.01 default
Description

Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON.

Pricing
$0.01 default
Parameters
{
  "properties": {
    "next_token": {
      "description": "Pagination cursor from previous response",
      "type": "string"
    },
    "query": {
      "description": "Search keyword or phrase",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
Example response
{
  "data": [
    {
      "description": "Running bitcoin.",
      "id": "9253672",
      "name": "Hal Finney",
      "public_metrics": {
        "followers_count": 134000,
        "following_count": 200,
        "like_count": 300,
        "tweet_count": 600
      },
      "username": "halfin",
      "verified": false
    }
  ],
  "meta": {
    "next_token": "abc123"
  }
}