Skip to content
Scrappa Get API key
X (Twitter) API 1 credit/request

X (Twitter) User Search

GET https://scrappa.co/api/x-twitter/search/users

Search public accounts by keyword.

X (Twitter) User Search 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/x-twitter/search/users
Auth header
x-api-key
Cost
1 credit/request
q = coffee shops
Response preview
200 OK
{
    "count": 1,
    "cursor": "DAABCgACF__sample_opaque_cursor",
    "results": [
        {
            "url": "https://x.com/example",
            "name": "NASA",
            "rest_id": "44196397",
            "verified": true,
            "followers": 12840000,
            "following": 2400,
            "screen_name": "example"
        }
    ]
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

3 optional filters available.

q string Required

Search query.

Example value coffee shops
cursor string Optional

Opaque cursor from the previous page. Pagination is driven by this value; the returned result count is the authoritative page size.

Example value 0
count integer Optional

Requested page size. Advisory only: the upstream sets the page size, so the returned result count is what matters.

Example value 10
lang string Optional

Result language code.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

count cursor results

Common results fields

url name rest_id verified
JSON Response
200 OK
{
    "count": 1,
    "cursor": "DAABCgACF__sample_opaque_cursor",
    "results": [
        {
            "url": "https://x.com/example",
            "name": "NASA",
            "rest_id": "44196397",
            "verified": true,
            "followers": 12840000,
            "following": 2400,
            "screen_name": "example"
        }
    ]
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.