Skip to main content
GET
/
gateway
/
v1
/
search
/
social
/
people
Social User Search
curl --request GET \
  --url https://api.ask.surf/gateway/v1/search/social/people
{
  "data": [
    {
      "followers_count": 123,
      "following_count": 123,
      "handle": "<string>",
      "name": "<string>",
      "user_id": "<string>",
      "avatar": "<string>",
      "bio": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "has_more": true,
    "limit": 123,
    "next_cursor": "<string>"
  },
  "$schema": "<string>"
}

Query Parameters

q
string
required

Search keyword or @handle for exact handle lookup. Use a keyword like vitalik for fuzzy matching across names and bios, or @VitalikButerin to find a specific account by handle

Example:

"vitalik"

limit
integer<int64>
default:20

Results per page

Required range: 1 <= x <= 100
Example:

20

cursor
string

Opaque cursor token from a previous response's next_cursor field for fetching the next page

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/CursorDataResponseXUser.json"