API Parameters - Scrapeless API

Parameters	Required	Desc
advertiser_id	true	Parameter defines the Google Advertiser ID. It can be found in the Ads Transparency Center advertiser URL. For example, the advertiser ID for the URL https://adstransparency.google.com/advertiser/AR17828074650563772417 is AR17828074650563772417 (Tesla Inc). It accepts either a single ID or multiple IDs separated by commas (,). Example, Single ID: AR17828074650563772417, Multiple IDs: AR17828074650563772417,AR03911981557522366465,...
region	true	Parameter defines from where you want the search to originate. By default it search results from anywhere.
platform	false	Parameter defines the target platform where ads are displayed. When not set, it will return results from all platforms (default). Available options: PLAY - Google Play, MAPS - Google Maps, SEARCH - Google Search, SHOPPING - Google Shopping, YOUTUBE - YouTube.
start_date	false	Parameter defines the start date for which you want the search results to begin. The format for this field is YYYYMMDD. Example: 20221201
end_date	false	Parameter defines the end date for which you want the search results to conclude. The format for this field is YYYYMMDD. Example: 20221231. To set the date for Today / Single Day, you should set end_date as start_date + 1 day.
creative_format	false	Parameter defines the format you want to filter by. Only search results with a similar format will be returned. Available options: text - Text, image - Image, video - Video
num	false	Parameter defines the maximum number of results to return. (e.g., 40 (default) returns 40 results and 100 returns 100 results).
next_page_token	false	Parameter defines the next page token. It is used for retrieving the next page results.
political_ads	false	The parameter determine if the advertiser promotes political advertisement. Political advertisement is a different category than regular advetisements, and will not appear on the results unless this parameter is set to true. If this parameter is set to true, only political advertisements will appear on the results. By default it is false.