DataForSEO SERP APIInstall

Summary

Retrieve advanced Google Ads search data filtered by advertiser domain or identifiers, location, ad format, platform, and optional date range.

Inputs

• target — Domain name associated with an advertiser account; required if advertiser_ids is not specified.
• advertiser_ids — Collection of advertiser IDs; required if domain name (target) is not specified.
• priority — Task execution priority, either normal or high.
• ads_search_location_name (required) — Full name of the search engine location to target for ads data.
• ads_location_coordinate — GPS coordinates of the location as latitude and longitude.
• platform — Advertising platform filter such as Google Search, Maps, Shopping, Youtube, or All.
• format — Ad format filter: image, text, video, or all.
• date_from — Start date for filtering ads data in yyyy-mm-dd format; must be specified if date_to is set.
• date_to — End date for filtering ads data in yyyy-mm-dd format; must be specified if date_from is set.
• depth — Number of results to retrieve, from 1 to 700, defaulting to 100.

Output shape

a JSON object containing detailed Google Ads search results matching the specified filters and parameters.

The response includes advanced advertising data such as ad impressions, clicks, positions, and other metrics. Either 'target' or 'advertiser_ids' must be provided. Date range filters are optional but must be complete pairs if used. Priority affects execution speed. Depth controls result count limit.

Examples

Example 1: Get Google Ads search data for a specific domain in a given location and platform over a date range.

Specify the domain name, location, platform, date_from, date_to, and optionally format and depth to retrieve detailed ads search data.

Links

• n8n community nodes installation guide