---
title: "Search users by Keyword"
method: POST
path: "/search-users"
tags: ["Search"]
---

# Search users by Keyword

`POST /search-users`

Searches for Twitter/X users by a keyword or phrase. You pass a query, and the endpoint returns a list of matching accounts with basic profile info like handle, user id, name, avatar, bio, follower stats, and verification or protected status. If there are more results, you will also receive a next\_cursor for pagination.

Use cases:

SaaS products letting users find accounts inside an app; analysts researching people, projects, or brands by name keywords; marketing teams building lists of relevant creators or company accounts; CRM or enrichment tools turning a keyword into a set of candidate profiles; developers implementing autocomplete or “search people” with cursor paging./

## Request body

- SearchSearchUsersReq
  - `next_cursor` string
  - `query` string

## Response `200`

OK

- CommonUsersResponse
  - `next_cursor` string
  - `users` CommonUser[]
    - `bio_urls` string[]
    - `can_dm` boolean
    - `created_at` string
    - `description` string
    - `display_name` string
    - `favourites_count` integer
    - `followers_count` integer
    - `followings_count` integer
    - `id` string
    - `location` string
    - `media_count` integer
    - `pinned_tweet_ids` string[]
    - `possibly_sensitive` boolean
    - `profile_background_image_url` string
    - `profile_image_url` string
    - `protected` boolean
    - `tweets_count` integer
    - `username` string
    - `verified` boolean

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sorsa/apis/api-sorsa-io-2.md) · [All operations](https://skmtc.net/sorsa/apis/api-sorsa-io-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sorsa/api-sorsa-io-2/revisions/3d7215317ba1/schema)