Authorizations
Query Parameters
Keyword to search for
"running"
If you want to search by exact phrase or not
keyword_unordered, keyword_exact_phrase "keyword_unordered"
Search for all ads or only political and issue ads
all, political_and_issue_ads "all"
This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
"ALL"
Status of the ad. Defaults to ACTIVE.
ALL, ACTIVE, INACTIVE "ACTIVE"
Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.
ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE "ALL"
Impressions start date. Needs to be in YYYY-MM-DD format.
"2025-01-05"
Impressions end date. Needs to be in YYYY-MM-DD format.
"2025-02-16"
Cursor to paginate through results
"AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"
Set to true for a trimmed down version of the response
false
Response
Successful response
Key Response Fields:
is_active: Whether the ad is currently runningad_archive_id: The actual ad id