X Tweet Search ($0
X Tweet Search ($0.02/call): Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.
20000 (raw units)
price
292
calls / 30d
11
unique payers
2026-09-18
updated
Provider
x402.botsmith.dev · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "20000",
"maxTimeoutSeconds": 60
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"query": "x402 payments",
"type": "Latest"
},
"type": "http"
},
"output": {
"example": {
"hasNextPage": true,
"nextCursor": "DAACCgACGgAAAAAAAAA",
"tweets": [
{
"author": {
"handle": "example",
"id": "44196397",
"name": "Example Dev"
},
"createdAt": "2026-07-01T07:00:30.000Z",
"hashtags": [
"x402"
],
"id": "1846987139428634858",
"lang": "en",
"links": [
"https://x402.org"
],
"mentions": [
"coinbase"
],
"metrics": {
"likes": 1200,
"quotes": 12,
"replies": 85,
"retweets": 340,
"views": 250000
},
"text": "Shipping the new agent payments stack today. HTTP 402 is finally real.",
"url": "https://x.com/example/status/1846987139428634858"
}
]
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Pagination cursor from a previous call",
"pattern": "^[A-Za-z0-9+/=_-]{1,400}$",
"type": "string"
},
"query": {
"description": "Search query, e.g. \"x402 from:coinbase since:2026-07-01\"",
"maxLength": 400,
"minLength": 1,
"type": "string"
},
"type": {
"default": "Latest",
"description": "Sort by recency or engagement",
"enum": [
"Latest",
"Top"
],
"type": "string"
}
},
"required": [
"query",
"type"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"hasNextPage": {
"type": "boolean"
},
"nextCursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tweets": {
"description": "Up to 20 matching posts",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"properties": {
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"handle",
"name",
"id"
],
"type": "object"
},
"createdAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO 8601"
},
"hashtags": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"lang": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"links": {
"description": "Expanded outbound URLs",
"items": {
"type": "string"
},
"type": "array"
},
"mentions": {
"description": "Mentioned handles",
"items": {
"type": "string"
},
"type": "array"
},
"metrics": {
"additionalProperties": false,
"properties": {
"likes": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"quotes": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"replies": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"retweets": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"views": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"likes",
"retweets",
"replies",
"quotes",
"views"
],
"type": "object"
},
"text": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"url",
"text",
"createdAt",
"lang",
"author",
"metrics",
"hashtags",
"links",
"mentions"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"tweets",
"hasNextPage",
"nextCursor"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://x402.botsmith.dev/x/search" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://x402.botsmith.dev/x/search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402.botsmith.dev/x/search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/482.json, and this resource appears in /discovery/resources and /discovery/search.