Skip to main content
GET
List an account's items

Authorizations

Authorization
string
header
required

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

Query Parameters

account
string

Account selector: a natural key such as youtube:UCX6OQ3DkcsbYNE6H8uQQuVA, :@handle such as instagram:@nike, or an account URL

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

Collection to list: YouTube videos, shorts or streams; Instagram posts or reels

Available options:
videos,
shorts,
streams,
posts,
reels
sort
enum<string>

Ordering: YouTube latest or popular; Meta Ad Library relevance or impressions

Available options:
latest,
popular,
relevance,
impressions
status
enum<string>
default:active

Which ads to list; Meta Ad Library only

Available options:
active,
inactive,
all
country
string
default:ALL

ALL, or a two-letter country code; Meta Ad Library only

Pattern: ^(ALL|[A-Za-z]{2})$
mediaType
enum<string>
default:all

Which creative kinds to list; Meta Ad Library only

Available options:
all,
video,
image
since
string<date>

Earliest ad start date, yyyy-mm-dd; Meta Ad Library only

until
string<date>

Latest ad start date, yyyy-mm-dd; Meta Ad Library only

cursor
string

Opaque cursor from a previous page

maxAge
string
default:15m

How fresh a stored page may be; default 15m

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

Response

One page of the account's items

object
string
required
Allowed value: "list"
data
object[]
required
Maximum array length: 100
page
object
required
total
integer | null
required
Required range: 0 <= x <= 9007199254740991
totalApproximate
boolean | null
required
account
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