List Posts

Retrieve Posts from a List’s timeline

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

Method	Endpoint	Description
GET	/2/lists/:id/tweets	Get 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

• An approved developer account
• A Project and App in the Developer Console
• Your App’s keys and tokens

Quickstart

Get Posts from a List

Integration guide

Key concepts and best practices

List lookup

Get List details

API Reference

Full endpoint documentation