x

Search X Lists

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.

get/x/lists/search

Request

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

Query parameters

expansionsstring
tweet.fieldsstring
user.fieldsstring
media.fieldsstring
place.fieldsstring
poll.fieldsstring
pagination_tokenstring
next_tokenstring
max_resultsinteger
querystring required

Headers

Unifapi-Version'2026-07-01'

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Response

OK

request_idstring required

UnifAPI request id for support and ledger correlation.

Changes

No recorded changes to this operation across all 1 revision of this API.