Skip to content
onelayer.
All tools

Tool detail

tweets

Returns the latest posts (about 100 per page) from a public X/Twitter List by its numeric List ID, as X v2-compatible JSON, with pagination.

Categories: Social media

Use when

  • get recent tweets from a specific X List by ID
  • paginate through a Twitter/X List's timeline

Not for

  • not the official X API - data is sourced from the public web
  • not tweet search or user timelines - a List ID is required

Inputs

GET query params: id (string, required, numeric X List ID); next_token (string, optional, pagination cursor).

Admitted input schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Numeric Twitter/X List ID"
    },
    "next_token": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Pagination cursor from previous response"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://x402.twit.sh/lists/tweets

Payment

Protocol
x402
Listed price
0.01 USDC per request on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://x402.twit.sh/lists/tweets
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z