---
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

## Changes

- **2024-11-04** `74bc9782b6a9` — 1 warning, 1 info
  - removed the optional property `results` from the response with the `200` status
  - added the optional property `users` to the response with the `200` status

[Change history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/twitter/search-users/post.md)

---

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