Skip to main content
GET
Get Top Ads

Authorizations

x-rapidapi-key
string
header
required

Query Parameters

page
integer
default:1

Page

Example:

1

period
enum<number>
default:30
Available options:
7,
30,
180
Example:

30

limit
integer
default:20

Number of items per page (maximum is 20)

Required range: x <= 20
Example:

20

country
string

Country code. Head here for a full list of supported countries

Example:

"US"

order_by
enum<string>
Available options:
impression,
ctr,
like,
cvr,
play_6s_rate,
play_2s_rate
like
enum<string>
Available options:
1,
2,
3,
4,
5
ad_format
enum<string>
Available options:
1,
2
objective
enum<string>
Available options:
1,
2,
3,
4,
5,
6,
7
industry
string

Head to here for a full list of Industry code. You can combine multiple industries by using a comma. For example: 22102000000,22101000000

ad_language
enum<string>

Ads language. Supported language: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko

Available options:
en,
es,
ar,
vi,
th,
de,
id,
pt,
fr,
ms,
nl,
ja,
it,
ro,
zh-Hant,
ko
keyword
string

Search ads keyword

Response

Success

data
object