Skip to main content
GET
Look up one public item

Authorizations

Authorization
string
header
required

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

Query Parameters

url
string
required

Absolute http or https URL of one post, video, short or ad

Required string length: 1 - 2048
include
enum<string>

Also return a transcript built from captions

Available options:
transcript
maxAge
string
default:1h

How fresh a stored observation must be to be served: 0 or a whole number of minutes, hours or days up to 365d, such as 30m, 1h or 7d. Default 1h; 0 always fetches live

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

Response

The item as it was observed

object
string
required
Allowed value: "item"
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
kind
enum<string>
required
Available options:
video,
short,
image,
carousel,
ad
url
string
required
Required string length: 1 - 2048
author
object | null
required
title
string | null
required
Maximum string length: 1000
text
string | null
required
Maximum string length: 10000
publishedAt
string | null
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)$
durationMs
integer | null
required
Required range: 0 <= x <= 9007199254740991
stats
object
required
thumbnails
object[]
required
Maximum array length: 64
transcript
object | null
required
unavailableFields
enum<string>[]
required
Maximum array length: 12
Available options:
author,
title,
text,
publishedAt,
durationMs,
stats.views,
stats.likes,
stats.comments,
stats.shares,
stats.saves,
thumbnails,
transcript
ad
object | null
required
tiktok
object | null
required
instagram
object | null
required
youtube
object | 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