X
XScraper

Search Profiles

GET

Search for Twitter profiles with cursor pagination

GET /api/v1/twitter/users/search_profiles

Authorization

X-API-Key
string
required

Parameters

NameTypeRequiredDescription
querystring
required
Search query
countnumber
optional
Number of results (1-100)
Default: 20
cursorstring
optional
Pagination cursor for fetching next page of results

Example Request

curl -X GET \
"https://api.xscraper.xyz/api/v1/twitter/users/search_profiles?query=elon" \
-H "X-API-Key: "

Response

Search Results
application/json
{
  "data": {
    "profiles": [
      {
        "username": "elonmusk",
        "name": "Elon Musk",
        "userId": "44196397",
        "bio": "Mars & Cars",
        "followersCount": 180000000,
        "followingCount": 700,
        "tweetsCount": 40000,
        "isVerified": true
      }
    ],
    "next": "cursor_token_for_next_page"
  },
  "meta": {
    "statusCode": 200,
    "timestamp": "2025-04-19T15:49:28.824Z"
  }
}

Error Responses

401 Unauthorized
{
  "statusCode": 401,
  "timestamp": "2025-04-19T15:49:28.824Z",
  "path": "/api/v1/twitter/users/search_profiles",
  "method": "GET",
  "message": "Invalid or expired API key"
}
400 Bad Request
{
  "statusCode": 400,
  "timestamp": "2025-04-19T15:49:28.824Z",
  "path": "/api/v1/twitter/users/search_profiles",
  "method": "GET",
  "message": "Query parameter is required"
}