/twitter/ads/search
Search X (Twitter) Ads Repository promoted tweets by advertiser, EU/EEA country and date range
Price: 5 credits per 50 results
💡 AI Hint: Search the X (Twitter) Ads Repository (EU/EEA ad transparency) for an advertiser’s promoted tweets. Provide the advertiser handle (e.g. ‘coinbase’), one or more EU/EEA countries, and a date range (start_date/end_date as YYYY-MM-DD). Each result is a promoted tweet shown in one country: tweet_id, line_item_id, account_id, country, advertiser, funding_instrument, approval_status, impression_count, reach_count and targeting. Coverage is limited to EU/EEA, as mandated by the DSA.
⚠️ Common errors: 412: Advertiser not found. Verify the handle.
Authorizations
API token from the dashboard
Headers
Body
Advertiser handle (screen name)
1"coinbase"
"Shopify"
Start of the delivery range (YYYY-MM-DD)
"2025-01-01"
End of the delivery range (YYYY-MM-DD)
"2026-06-22"
Max number of results
x >= 1Max scrapping execution timeout (in seconds)
20 <= x <= 1500EU/EEA countries where the ads were shown
1AX, 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