DataForSEO SERP APIInstall

Summary

Retrieve advanced live Google Ads search data for a specified advertiser or domain within a given location and optional parameters such as ad platform, format, date range, and search depth.

Inputs

• target — Domain name associated with an advertiser account. Required if 'advertiser_ids' is not specified.
• advertiser_ids — List of advertiser identifiers. Required if 'target' is not specified.
• priority — Task execution priority: normal (1) or high (2). Defaults to normal.
• ads_search_location_name (required) — Full name of the search engine location where ads are served (must match supported locations in DataForSEO docs).
• ads_location_coordinate — GPS coordinates of a location to refine ad search location, e.g., "53.476225,-2.243572".
• platform — Advertising platform filter. Options include all, Google Maps, Google Play, Google Search, Google Shopping, and YouTube.
• format — Ad format filter: all, image, text, or video ads.
• date_from — Starting date for the time range to retrieve ads (format yyyy-mm-dd). Must be specified if 'date_to' is given. Minimum allowed date is 2018-05-31.
• date_to — Ending date for the time range (format yyyy-mm-dd). Must be specified if 'date_from' is given. Maximum allowed date is the current date.
• depth — Number of ad results to retrieve, with a minimum of 1 and maximum of 700. Defaults to 100.

Output shape

a list of structured records representing live Google Ads search results matching the specified criteria

The operation returns detailed ad data for a specified advertiser or domain filtered by location, platform, ad format, date range, and result depth. At least one of 'target' or 'advertiser_ids' must be provided. Pagination or partial results are not explicitly documented.

Links

• n8n community nodes installation guide