Twitter List Timeline API - Posts from Curated Accounts

Supply required list_id as the string ID of a known public X List. Optional cursor continues available posts from that same List. A List timeline is a collection associated with curated member accounts, not a personalized home feed. Exact post fields, response pagination keys and private or unavailable-List behavior have not been live-verified. Retain the List ID and collection time, validate returned tweet identifiers before deduplication and do not assume complete membership activity or full historical coverage.

API Features

Curated-List content selection list_id targets a specific List rather than a username or a keyword search query.

List-specific feed context The described collection supports observing curated-account activity without pretending to be a personalized home timeline.

List timeline cursor input Optional cursor supports further available List posts after continuation response keys are validated.

Source-preserving List collection Retain the List selection and collection time, then validate tweet identifiers for deduplication and downstream citation.

Live API Demo

GET /api/project/twitter/list-timeline

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/twitter/list-timeline?key=<API_KEY>&list_id=<list_id>'

curl -X GET 'https://api.opendata-api.com/api/project/twitter/list-timeline?key=<API_KEY>&list_id=<list_id>'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Collect available posts from a sector List for an editorial briefing with source-linked references.
Maintain a bounded monitoring feed for curated industry voices instead of an algorithmic home feed.
Compare observed discussion themes across selected Lists collected over equivalent time windows.
Refresh a newsroom's List-based reading queue while retaining List IDs and deduplicating validated post IDs.

Frequently asked questions

What do I need to read a public List timeline?

A known public list_id is required; optional cursor continues posts for the same List. The collection concerns curated member accounts rather than a personalized home feed. Validate post identifiers and output pagination fields before parsing.

Does a List timeline contain all historical member activity?

No full-history or complete-membership-activity guarantee is established. Exact fields and unavailable or private-List behavior are unverified. Keep the List ID, collection time and coverage notes with the returned sample.

Related operations

Guides

View Subscription Plans →

Get Posts from a Public List