X User Search
GET
/v1/x/users/searchMCP
x_user_search3 creditsLiveUpdated
Description
Find X accounts by keyword in their name or bio, for example 'founder saas' or 'growth marketer'. Returns profiles with follower counts and DM availability. Costs 3 credits per page of about 20. Tip: X search matches bios loosely; check bio text before treating a result as a fit.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
q | query | string | yes | Keywords to match in names and bios. | |
limit | query | integer | no | 20 | Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. |
cursor | query | string | no | Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048. |
- q query, string, required
- Keywords to match in names and bios.
- limit query, integer
- Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. Default
20. - cursor query, string
- Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
Request examples
curl "https://chatterapi.com/v1/x/users/search?q=crm+founder" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is a list of XUser, with page.nextCursor and page.hasMore for the next page. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | no | Platform id. |
handle | string | no | Handle without @. |
name | string | no | Name. |
bio | string | yes | Profile bio. |
followers | number | yes | Follower count. |
following | number | yes | Following count. |
tweets | number | yes | Tweet count. |
verified | boolean | yes | Legacy verification. |
blueVerified | boolean | yes | Paid blue check. |
canDm | boolean | yes | Whether the account accepts DMs from anyone. |
protected | boolean | yes | Protected (private) account. |
location | string | yes | Profile location. |
url | string | yes | Website in the profile. |
avatarUrl | string | yes | Avatar image URL. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
response
{
"data": [
{
"id": "187133114",
"handle": "crmfinder",
"name": "CRM-Finder Schweiz",
"bio": "Unabhängige Wissens- und Informationsplattform für den Schweizer CRM- und ERP-Markt. \nhttps://t.co/EkvkD7iLNw",
"followers": 923,
"following": 1845,
"tweets": 1665,
"verified": false,
"blueVerified": false,
"canDm": false,
"protected": null,
"location": "Switzerland, 8050 Zurich",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/872769982052093952/ntk1iR0W_400x400.jpg",
"createdAt": "2010-09-05T10:38:19.000Z"
},
{
"id": "850020787423592448",
"handle": "FOUNDRY2021",
"name": "FOUNDRY - The World's Fastest, Most Intuitive CRM",
"bio": null,
"followers": 113,
"following": 695,
"tweets": 396,
"verified": false,
"blueVerified": false,
"canDm": false,
"protected": null,
"location": "Los Angeles, CA ",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/1400604081996013572/BL3Lkelt_400x400.jpg",
"createdAt": "2017-04-06T16:22:03.000Z"
},
{
"id": "1608265032906993666",
"handle": "CrmFender",
"name": "Fender CRM Portal",
"bio": null,
"followers": 0,
"following": 1,
"tweets": 0,
"verified": false,
"blueVerified": false,
"canDm": false,
"protected": null,
"location": null,
"url": null,
"avatarUrl": "https://abs.twimg.com/sticky/default_profile_images/default_profile_400x400.png",
"createdAt": "2022-12-29T00:54:05.000Z"
}
],
"page": {
"nextCursor": null,
"hasMore": false
},
"credits": {
"charged": 3,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.
Credits
3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 1 hour are served from cache.