---
title: "List Articles"
method: GET
path: "/article/list"
tags: ["Articles"]
---

# List Articles

`GET /article/list`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/article/list`
- Auth: HTTP bearer

List the caller's own articles at one lifecycle at a time: Draft or Published (default Draft). X exposes no combined view across both, so call it twice, once per lifecycle, to see everything. Cursor-paginated. Requires a registered session. Billed at $0.0008 per call. Cost: $0.0008 per call.

## Query parameters

- `lifecycle` string: Which set of articles to list: "draft" or "published". Defaults to "draft".
- `count` integer: Items per page. Defaults to 20; capped at 100.
- `cursor` string: Pagination cursor from a previous response's next_cursor.
- `fields` string
- `compact` '1'

## Response `200`

List your own articles, filtered by lifecycle (draft or published).

- object
  - `count` integer: Number of articles returned in this page.
  - `next_cursor` string, nullable: Opaque cursor for the next page, or null when the list ends.
  - `articles` object[]: Articles at the requested lifecycle, for this page. Each item: id, rest_id, title, preview_text, lifecycle, content_state, cover_media, media_entities, author, created_at_secs, modified_at_secs, first_published_at_secs, visibility_setting, tweet_id, public_url.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)