---
title: "Search List"
method: POST
path: "/twitter/list/search"
tags: ["Lists Endpoints"]
---

# Search List

`POST /twitter/list/search`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/list/search`
- Auth: HTTP bearer

Search list

## Request body

- SearchListQuery
  - `query` string, required: The query to search for.
  - `target_count` integer, required: The number of lists to search.

## Response `200`

A list of list objects.

- SearchListResponse
  - `code` integer, required: The status code of the response.
  - `msg` string, required: The message of the response.
  - `data` ListModel[], required: A list of list objects.
    - `id` string, required: The ID of the list
    - `name` string, required: The name of the list
    - `description` string, required: The description of the list
    - `is_private` boolean, required: Whether the list is private
    - `member_count` integer, required: The number of members in the list
    - `subscriber_count` integer, required: The number of subscribers in the list

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)