---
title: "Search Twitter for users"
method: POST
path: "/twitter/search-users"
tags: ["Twitter"]
---

# Search Twitter for users

`POST /twitter/search-users`

Search users on Twitter for a given query

## Request body

- object
  - `query` string, required — The search query string
  - `count` integer — The number of results to retrieve

## Response `200`

SearchUsers API successful response

- object
  - `users` TwitterUser[]
    - `user_id` string — Unique identifier for the user
    - `username` string — The user's username
    - `name` string — The name of the user
    - `description` string — A brief description of the user
    - `url` string, uri — The attached URL on the user's profile page
    - `following_count` integer — Number of users the user is following
    - `follower_count` integer — Number of followers the user has

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/versions/22587fdf9a5e/schema)