# Twitter/X List Details

> Twitter/X List Details 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).

Retrieves complete public metadata and information for a specific X (Twitter) list by its numeric list ID.

## Facts

- Endpoint: GET https://twitter.use.x402atlas.com/list-details
- 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-details-2e049ef2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GUNWnb_W3ERI-qvrb6XUx

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-details-2e049ef2
```

Example prompt: Can you pull up the full details for X list ID 1234567890 — I want to know the name, description, owner, and member count?

## When to prefer this

Use this endpoint when you need complete metadata about a specific X list and already have its numeric list ID. It is ideal for verifying list existence, reading owner and description details, or enriching data pipelines with list profile information. Prefer this over search-based endpoints when you have the exact list ID and need authoritative, structured list data rather than search results.

## Known failure modes

- Invalid list_id format (non-numeric or too long) returns a validation error
- List ID does not exist or has been deleted returns a not-found error
- List is private or restricted and not accessible to the API returns an access error
- Rate limiting by the upstream X API causes temporary failures
- Network timeout if X API is slow to respond

## How this service works

Get complete public information for an X list.

## Output

Returns a JSON object containing the complete public metadata for the specified X list, including fields such as list name, description, owner account info, member and subscriber counts, visibility (public/private), creation timestamp, and any other available profile data. Also includes a queried_at timestamp indicating when the data was fetched.

## 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"
     ],
     "properties": {
      "data": {
       "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "name": "Technology",
   "id_str": "1309482935804932102",
   "description": "Technology accounts and news",
   "member_count": 120,
   "subscriber_count": 4500
  },
  "queried_at": "2026-07-26T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-list-details-2e049ef2/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)