When should an agent use the X (Twitter) search node?

You need real-time reaction, news or discussion on a topic. It is not meant for follower lists, private accounts or direct messages. A call usually takes about 4 seconds.

What does the X (Twitter) search node return?

Search recent posts on X by keyword, hashtag or from:account: 20 posts with text, likes, reposts, replies, views, date and link. No X account or key needed. Each call returns 20 posts: text, author handle and follower count, likes, reposts, replies, quotes, views, date, media and link.

How much does one call cost?

$0.006 in USDC on Base per search (up to 20 posts) (one call = up to 20 posts), charged only when it succeeds. No sign-up, subscription or API key.

What happens if the call fails?

You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.

How does an AI agent pay?

With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.

Can I use an API key instead?

Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.

Illustration: a stream of short message cards with a repost arrow, a heart and a magnifying glass

X (Twitter) search

Search recent posts on X by keyword, hashtag or from:account: 20 posts with text, likes, reposts, replies, views, date and link. No X account or key needed.

POST /api/v1/nodes/x-search

Price

$0.006

per search (up to 20 posts)

One call gets you up to 20 posts. You only pay when it works: if a call fails, it costs nothing.

Use it from your AI assistant

Paste this once into Claude Code, Cursor or Codex. After that, just ask, for example: “what are people on Reddit saying about this product?”. Your assistant finds this node and pays for it by itself.

connect TollNode (one time)

npx agentcash add https://tollnode.com

For developers: call it directly

terminal

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/x-search -m POST -b '{"query":"x402 payments"}'

Is this the right node?

Use it when: You need real-time reaction, news or discussion on a topic.
Not for: Follower lists, private accounts or direct messages.
You get: 20 posts: text, author handle and follower count, likes, reposts, replies, quotes, views, date, media and link.
Typical time: About 4 seconds per call

How it works

Your agent pays for itself

Explained in 5 minutes →

1Needs something
2Finds it on TollNode
3Pays a few cents
4Gets the result

Two ways to use X (Twitter) search

Way 1 · Pay per call (x402)

For AI agents, no sign-up

Your agent sends the request, gets a 402 with the exact price ($0.006 per search (up to 20 posts)), signs a USDC payment on Base and retries. Nothing is collected unless the call succeeds.

add TollNode to Claude Code, Cursor or Codex (once)

npx agentcash add https://tollnode.com

or call it directly

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/x-search -m POST -b '{"query":"x402 payments"}'

Way 2 · Account + API key

For apps and teams

Create a free account, load a balance with USDC on Base, create an API key and call any node. Same prices; each successful call is deducted from your balance.

curl

curl -X POST https://tollnode.com/api/v1/nodes/x-search \
  -H "Authorization: Bearer $TOLLNODE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"x402 payments"}'

Step-by-step, with code in JavaScript and Python: full guide for X (Twitter) search.

Input

Field	Type	Notes
query*	string	Search query; X search operators work, e.g. x402 payments, #bitcoin, from:nasa
sortBy	enum	Optional, default Latest (Latest, Top)

Example response

{
  "results": [
    {
      "id": "2119501456730403300",
      "url": "https://x.com/GREATVVIP/status/2119501456730403300",
      "lang": "en",
      "text": "A notary can stamp your signature. 𝗔 𝗻𝗼𝘁𝗮𝗿𝘆 𝗰𝗮𝗻'𝘁 𝗰𝗵𝗮𝗻𝗴𝗲 𝗮 𝘀𝗶𝗻𝗴𝗹𝗲 𝘄𝗼𝗿𝗱 𝗼𝗳 𝘄𝗵𝗮𝘁 𝘆𝗼…",
      "type": "tweet",
      "isReply": false,
      "entities": {
        "urls": [],
        "hashtags": [
          {}
        ],
        "user_mentions": [
          {}
        ]
      },
      "isPinned": false,
      "createdAt": "Sun Nov 08 18:45:00 +0000 2026",
      "isRetweet": false,
      "likeCount": 0,
      "noteTweet": {
        "id": "Tm90ZVR3ZWV0OjIxMTk1MDE0NTY1NjI1ODU2MDA=",
        "text": "A notary can stamp your signature. 𝗔 𝗻𝗼𝘁𝗮𝗿𝘆 𝗰𝗮𝗻'𝘁 𝗰𝗵𝗮𝗻𝗴𝗲 𝗮 𝘀𝗶𝗻𝗴𝗹𝗲 𝘄𝗼𝗿𝗱 𝗼𝗳 𝘄𝗵𝗮𝘁 𝘆𝗼…",
        "noteId": "2119501456562585600",
        "entities": {
          "urls": [],
          "hashtags": [
            {}
          ],
          "user_mentions": [
            {}
          ]
        },
        "isExpandable": true
      },
      "viewCount": 14,
      "quoteCount": 0,
      "replyCount": 0,
      "isNoteTweet": true,
      "retweetCount": 0,
      "bookmarkCount": 0,
      "isQuoteStatus": false,
      "conversationId": "2119501456730403300",
      "isTranslatable": false,
      "possiblySensitive": false
    }
  ]
}

FAQ

When should an agent use the X (Twitter) search node?: You need real-time reaction, news or discussion on a topic. It is not meant for follower lists, private accounts or direct messages. A call usually takes about 4 seconds.
What does the X (Twitter) search node return?: Search recent posts on X by keyword, hashtag or from:account: 20 posts with text, likes, reposts, replies, views, date and link. No X account or key needed. Each call returns 20 posts: text, author handle and follower count, likes, reposts, replies, quotes, views, date, media and link.
How much does one call cost?: $0.006 in USDC on Base per search (up to 20 posts) (one call = up to 20 posts), charged only when it succeeds. No sign-up, subscription or API key.
What happens if the call fails?: You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
How does an AI agent pay?: With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.
Can I use an API key instead?: Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.