Skip to content
Endless Documentation

Find a social account's picture

GET
/users/{user_id}/social-profile/avatar

Where an account's profile picture lives. avatar_url is null when the account doesn't exist or shows no picture. 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
kind?string

LinkedIn only: whether the handle is a person, a company or a school.

Value in

  • "person"
  • "company"
  • "school"

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/avatar?platform=instagram&username=string"
{  "avatar_url": "string"}