Skip to main content
GET
Search a platform

Authorizations

Authorization
string
header
required

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

Query Parameters

platform
enum<string>
required

Which platform to search

Available options:
youtube,
meta_ad_library
q
string

Search phrase, one to 200 characters

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

Result kind; Meta Ad Library accepts accounts only

Available options:
items,
accounts
uploadDate
enum<string>

Item upload date filter; YouTube only

Available options:
today,
week,
month,
year
duration
enum<string>

Item duration filter; YouTube only

Available options:
short,
medium,
long
sort
enum<string>
default:relevance

Search ordering; YouTube only

Available options:
relevance,
popular
country
string
default:ALL

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

Pattern: ^(ALL|[A-Za-z]{2})$
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 search results

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