POST /v1/data/google-ads/ads/run
Pricing: $0.002 per ad ($2.00 per 1,000).
Ways to call it
- By website: set
domains(optional:country,maxResults) - By advertiser: set
advertisers(optional:country,maxResults)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Advertiser websites to find ads for, one per line, e.g. nike.com. A bare host or a full URL both work; returns the ads Google shows that send people to that site.
Advertiser names (HubSpot) or Google advertiser IDs (AR13611357312189988865), one per line. A name matches up to 3 advertiser accounts, which share that name’s share of Max Results. Not a link: use Domains for a website.
Only ads shown in this country. Any country by default.240 allowed values, for example
af (Afghanistan), al (Albania), dz (Algeria), as (American Samoa), ad (Andorra), ao (Angola), ai (Anguilla), aq (Antarctica), ag (Antigua and Barbuda), ar (Argentina). Fetch the full list with GET /v1/data/google-ads/ads?expand=options.Example
Response fields
Each row indata is one ad, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For Meta ads usefacebook/ads; for TikTok ads use tiktok/ads.