---
title: "Search X Lists"
method: GET
path: "/x/lists/search"
tags: ["x"]
---

# Search X Lists

`GET /x/lists/search`

## Request

- Base URL: `https://api.unifapi.com`
- URL: `https://api.unifapi.com/x/lists/search`
- Auth: HTTP bearer

Search public X Lists by query string and return a cursor-paginated set of matching Lists with their metadata. Useful for discovering curated account collections around a topic, industry, or community.

## Query parameters

- `expansions` string
- `tweet.fields` string
- `user.fields` string
- `media.fields` string
- `place.fields` string
- `poll.fields` string
- `pagination_token` string
- `next_token` string
- `max_results` integer
- `query` string, required

## Headers

- `Unifapi-Version` '2026-07-01'

## Response `200`

OK

- object
  - `request_id` string, required: UnifAPI request id for support and ledger correlation.
  - `data` XList[], required
    - `id` string, required
    - `name` string, required
    - `description` string
    - `url` string
    - `member_count` number
    - `follower_count` number
    - `private` boolean
  - `pagination` Pagination, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
  - `billing` Billing, required
    - `credits_charged` integer, required
    - `records_charged` integer, required
    - `balance_remaining` integer, required
    - `truncated_due_to_balance` boolean, required

## Other responses

- `400`: Validation or invalid-id error
- `401`: Missing, invalid, disabled, revoked, or expired UnifAPI API key
- `402`: Insufficient workspace credits
- `404`: Resource not found
- `429`: Rate limited
- `500`: Internal error
- `502`: Source error
- `503`: Source unavailable

---

[API](https://skmtc.dev/unifapi/apis/unifapi.md) · [All operations](https://skmtc.dev/unifapi/apis/unifapi/llms.txt) · [OpenAPI document](https://skmtc.dev/unifapi/apis/unifapi/revisions/1af90697ec4e?raw)