x402.twit.sh Bulk Tweet Lookup

x402

x402.twit.sh Bulk Tweet Lookup is a paid API for AI agents from x402.twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29, last successful call 2026-07-15).

Bulk fetch up to 50 Twitter/X tweets by their numeric IDs, returning full text, author profiles, and engagement metrics in a single request.

Price / call$0.01

Seller volume →—

Success100%

StatusUnknown

How this service works

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.

Output

Returns an X v2 API-compatible JSON object containing an array of tweet objects, each with full tweet text, author profile information (username, display name, profile data), and engagement metrics (likes, retweets, replies, quotes) for each requested tweet ID.

Example use cases

Example prompt

“Can you pull the full details — text, author, and engagement metrics — for these tweet IDs: 1110302988, 1234567890, and 9876543210?”

Technical details

Endpoint

GEThttps://x402.twit.sh/tweets?utm_source=zero.xyz

When to prefer

Use this endpoint when you have a known list of tweet IDs (up to 50) and need their full content, author profiles, and engagement metrics in one call. Prefer this over single-tweet lookups when processing multiple tweets at once to save on API calls and cost. Ideal for analytics pipelines, content archiving, or enriching datasets that already contain tweet IDs.

Side effects

Invalid or non-numeric tweet IDs return an error response
More than 50 IDs submitted causes a validation error
Deleted or suspended tweet IDs return empty or null entries
Malformed comma-separated string causes a parse error
Payment failure (402) if USDC balance is insufficient

Input

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "ids": "1110302988,1234567890,9876543210"
    }
  },
  "output": {
    "type": "object"
  }
}

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

{
  "data": [
    {
      "id": "1110302988",
      "lang": "en",
      "text": "Running bitcoin",
      "author": {
        "id": "9253672",
        "name": "halfin",
        "entities": {
          "description": {}
        },
        "location": "Santa Barbara, CA",
        "username": "halfin",
        "verified": true,
        "protected": false,
        "created_at": "2007-10-04T22:29:39.000Z",
        "description": "",
        "verified_type": "blue",
        "public_metrics": {
          "like_count": 1,
          "media_count": 3,
          "tweet_count": 66,
          "listed_count": 780,
          "followers_count": 151712,
          "following_count": 29
        },
        "pinned_tweet_id": "1110302988",
        "profile_image_url": "https://pbs.twimg.com/profile_images/287413224/hal_normal.jpg",
        "profile_banner_url": ""
      },
      "author_id": "9253672",
      "created_at": "Sun Jan 11 03:33:52 +0000 2009",
      "public_metrics": {
        "like_count": 133862,
        "quote_count": 14087,
        "reply_count": 11669,
        "retweet_count": 44688,
        "bookmark_count": 11524
      },
      "reply_settings": "everyone",
      "conversation_id": "1110302988",
      "possibly_sensitive": false,
      "edit_history_tweet_ids": [
        "1110302988"
      ]
    },
    {
      "id": "1234567890",
      "lang": "el",
      "text": "Αρσεναλ - Σάντερλαντ: (X) 0-0 τελικό",
      "author": {
        "id": "18934481",
        "name": "Pathfinder Sports",
        "entities": {
          "url": {
            "urls": [
              {
                "url": "http://t.co/qbweZ7AFAI",
                "indices": [
                  0,
                  22
                ],
                "display_url": "news.pathfinder.gr/sports",
                "expanded_url": "http://news.pathfinder.gr/sports"
              }
            ]
          },
          "description": {}
        },
        "location": "Heraklion, Crete",
        "username": "pathfinderSport",
        "verified": false,
        "protected": false,
        "created_at": "2009-01-13T10:15:21.000Z",
        "description": "Αθλητικά νέα από το Pathfinder Sports",
        "public_metrics": {
          "like_count": 0,
          "media_count": 0,
          "tweet_count": 109506,
          "listed_count": 32,
          "followers_count": 3430,
          "following_count": 6
        },
        "profile_image_url": "https://pbs.twimg.com/profile_images/71248884/twitter-icons_normal.jpg",
        "profile_banner_url": ""
      },
      "author_id": "18934481",
      "created_at": "Sat Feb 21 16:55:22 +0000 2009",
      "public_metrics": {
        "like_count": 7739,
        "quote_count": 5745,
        "reply_count": 14461,
        "retweet_count": 5489,
        "bookmark_count": 4975
      },
      "reply_settings": "everyone",
      "conversation_id": "1234567890",
      "possibly_sensitive": false,
      "edit_history_tweet_ids": [
        "1234567890"
      ]
    },
    {
      "id": "9876543210",
      "lang": "tl",
      "text": "@sansantan okeee (: heheh thankiee",
      "author": {
        "id": "34513448",
        "name": "Mariam",
        "entities": {
          "description": {}
        },
        "location": "",
        "username": "mpornx",
        "verified": false,
        "protected": false,
        "created_at": "2009-04-23T03:17:18.000Z",
        "description": "",
        "public_metrics": {
          "like_count": 1,
          "media_count": 18584,
          "tweet_count": 58770,
          "listed_count": 6,
          "followers_count": 773,
          "following_count": 0
        },
        "profile_image_url": "https://pbs.twimg.com/profile_images/619704141904916480/Y3jdzdNb_normal.jpg",
        "profile_banner_url": "https://pbs.twimg.com/profile_banners/34513448/1436645212"
      },
      "author_id": "34513448",
      "created_at": "Tue Mar 02 14:34:56 +0000 2010",
      "public_metrics": {
        "like_count": 57,
        "quote_count": 25,
        "reply_count": 124,
        "retweet_count": 36,
        "bookmark_count": 1
      },
      "reply_settings": "everyone",
      "conversation_id": "9876543210",
      "possibly_sensitive": false,
      "edit_history_tweet_ids": [
        "9876543210"
      ]
    }
  ]
}

Schema · Response

{
  "type": "json",
  "example": {
    "data": [
      {
        "id": "1110302988",
        "text": "Running bitcoin",
        "author": {
          "id": "9253672",
          "name": "Hal Finney",
          "username": "halfin"
        },
        "created_at": "2009-01-11T03:39:18.000Z",
        "public_metrics": {
          "like_count": 134000,
          "quote_count": 3500,
          "reply_count": 5400,
          "retweet_count": 32000
        }
      }
    ]
  }
}

Reviews

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"