Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

The List Posts endpoint lets you retrieve Posts from a List’s timeline. Get the latest Posts from all members of a List.

​
Overview

List timeline

Get Posts from List members

Curated feed

Access your curated content feeds

​
Endpoint

MethodEndpointDescription
GET/2/lists/:id/tweetsGet Posts from a List

​
Example request

curl "https://api.x.com/2/lists/1234567890/tweets?\
tweet.fields=created_at,author_id,public_metrics&\
expansions=author_id&\
user.fields=username&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
Getting started

Prerequisites

Quickstart

Get Posts from a List

Integration guide

Key concepts and best practices

List lookup

Get List details

API Reference

Full endpoint documentation