# Twitter/X List Tweets

> Twitter/X List Tweets is a paid API for AI agents from twitter.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches the recent posts from a specified public X (Twitter) list by its numeric list ID.

## Facts

- Endpoint: GET https://twitter.use.x402atlas.com/list-tweets
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-list-tweets-597e6ab5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TpsRvciBsKf9UPgS-5vvM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability twitter-x-list-tweets-597e6ab5
```

Example prompt: Pull the latest tweets from the public X list with ID 84839422 and show me what's been posted.

## When to prefer this

Use this endpoint when you need to retrieve tweets from a specific curated X list by its numeric ID, rather than searching by keyword or pulling a single user's timeline. Ideal for monitoring aggregated feeds of multiple accounts organized into a list, or for regularly polling a curated group of sources.

## Known failure modes

- Invalid or non-numeric list_id returns a validation error
- Private or deleted list returns an access error or empty result
- List ID that doesn't exist returns a not-found error
- X API rate limits may cause temporary failures
- Missing required list_id parameter returns a 400 bad request

## How this service works

Get posts from a public X list.

## Output

Returns a JSON object containing an array of tweet objects (each with full post data), the total result count, the UTC timestamp when the query was made, and an optional opaque cursor string for fetching the next page of results when more tweets are available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "list_id"
     ],
     "properties": {
      "list_id": {
       "type": "string",
       "pattern": "^[0-9]{1,25}$",
       "maxLength": 25,
       "description": "Decimal X list identifier"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "data",
      "result_count"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": true
       }
      },
      "cursor": {
       "type": "string",
       "description": "Opaque cursor for the next page, when supplied by X"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time"
      },
      "result_count": {
       "type": "integer",
       "minimum": 0
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "user": {
     "name": "Bill Gates",
     "id_str": "50393960",
     "screen_name": "BillGates"
    },
    "id_str": "1903602810652082591",
    "full_text": "Example X post",
    "created_at": "Sun Mar 23 12:00:00 +0000 2025",
    "reply_count": 8,
    "retweet_count": 15,
    "favorite_count": 120
   }
  ],
  "cursor": "NEXT_PAGE_CURSOR",
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-list-tweets-597e6ab5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.use.x402atlas.com](https://www.zero.xyz/host/twitter.use.x402atlas.com/llms.txt)