Skip to main content
POST
/twitter/ads/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
advertiser
string
required
Minimum string length: 1
start_date
string
required
end_date
string
required
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
countries
enum<string>[]
Minimum array length: 1
Available options:
AX,
AL,
AD,
AT,
BY,
BE,
BA,
BG,
HR,
CY,
CZ,
DK,
EE,
FO,
FI,
FR,
DE,
GI,
GR,
GG,
HU,
IS,
IE,
IM,
IT,
JE,
XK,
LV,
LI,
LT,
LU,
MK,
MT,
MD,
MC,
ME,
NL,
NO,
PL,
PT,
RO,
SM,
RS,
SK,
SI,
ES,
SJ,
SE,
CH,
UA,
GB,
VA

Response

Successful Response

tweet_id
string
required
@type
string
default:TwitterAd
line_item_id
string | null
account_id
string | null
country
string | null
advertiser
object | null
funding_instrument
object | null
approval_status
string | null
impression_count
integer | null
reach_count
integer | null
targeting
object[]