Skip to main content
POST
/
api
/
twitter
/
ads
/
search
/twitter/ads/search
curl --request POST \
  --url https://api.anysite.io/api/twitter/ads/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "advertiser": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "count": 2,
  "timeout": 300,
  "countries": [
    "FR"
  ]
}
'
[
  {
    "tweet_id": "<string>",
    "@type": "@twitter_ad",
    "line_item_id": "<string>",
    "account_id": "<string>",
    "country": "<string>",
    "advertiser": {
      "@type": "@twitter_ad_account",
      "name": "<string>",
      "is_deleted": false
    },
    "funding_instrument": {
      "@type": "@twitter_ad_funding_instrument",
      "type": "<string>",
      "currency": "<string>"
    },
    "approval_status": "<string>",
    "impression_count": 123,
    "reach_count": 123,
    "targeting": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
advertiser
string
required

Advertiser handle (screen name)

Minimum string length: 1
Examples:

"coinbase"

"Shopify"

start_date
string
required

Start of the delivery range (YYYY-MM-DD)

Example:

"2025-01-01"

end_date
string
required

End of the delivery range (YYYY-MM-DD)

Example:

"2026-06-22"

count
integer
required

Max number of results

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
countries
enum<string>[]

EU/EEA countries where the ads were shown

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:@twitter_ad
line_item_id
string | null
account_id
string | null
country
string | null
advertiser
TwitterAdAccount · object
funding_instrument
TwitterAdFundingInstrument · object
approval_status
string | null
impression_count
integer | null
reach_count
integer | null
targeting
TwitterAdTargeting · object[]