Skip to content
Endless Documentation

Look up a social account

GET
/users/{user_id}/social-profile

Who an account is on one platform — display name and headline counts. profile is null when the handle is not an account there. Not charged.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from authentication

In: header

Path Parameters

user_id*string
Match^user_

Query Parameters

platform*string

Value in

  • "instagram"
  • "x"
  • "linkedin"
  • "youtube"
  • "tiktok"
  • "facebook"
username*string

The account's handle, @handle or profile URL.

Length1 <= length <= 300

Header Parameters

Endless-Api-Version?string

Pin the caller to an API major (1). Omit to accept the current version. A major this deployment cannot serve is refused with 400 unsupported_api_version.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/user_abc123/social-profile?platform=instagram&username=string"
{  "profile": {    "platform": "instagram",    "handle": "string",    "display_name": "string",    "avatar_url": "string",    "followers": 0,    "following": 0,    "posts": 0,    "linkedin_kind": "person"  }}