Skip to main content
GET
Look up an account

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

url
string<uri>

Absolute HTTP(S) YouTube, Instagram or TikTok account URL

Maximum string length: 2048
platform
enum<string>

The account platform when using handle or id

Available options:
youtube,
instagram,
tiktok
handle
string

Account handle, with or without @

Required string length: 1 - 31
id
string

24-character YouTube channel id; YouTube only

Pattern: ^UC[A-Za-z0-9_-]{22}$
maxAge
string
default:1h

How fresh a stored page may be: 0 or minutes, hours or days up to 1d; default 1h

Pattern: ^(0|[1-9][0-9]{0,5}[mhd])$

Response

The account as it was observed

object
string
required
Allowed value: "account"
id
string
required
Pattern: ^(youtube|tiktok|instagram|meta_ad_library):[A-Za-z0-9._-]{1,128}$
platform
enum<string>
required
Available options:
youtube,
tiktok,
instagram,
meta_ad_library
handle
string | null
required
Required string length: 1 - 256
name
string | null
required
Maximum string length: 500
description
string | null
required
Maximum string length: 5000
url
string | null
required
Required string length: 1 - 2048
avatar
object[]
required
Maximum array length: 64
banner
object[]
required
Maximum array length: 64
verified
boolean | null
required
stats
object
required
Maximum array length: 32
country
string | null
required
Maximum string length: 100
joinedAt
string | null
required
Pattern: ^\d{4}-\d{2}-\d{2}$
unavailableFields
enum<string>[]
required
Maximum array length: 13
Available options:
handle,
name,
description,
url,
avatar,
banner,
verified,
stats.followers,
stats.following,
stats.items,
stats.views,
country,
joinedAt
youtube
object | null
required
tiktok
object | null
required
instagram
object | null
required
meta_ad_library
null
required
observedAt
string
required
Pattern: ^\d{4}-(0[1-9]|1[0-2])-([0-2]\d|3[01])T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$
cached
boolean
required
usage
object
required