Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
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.
string[]
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.
string
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.
integer
default:"100"
How many ads to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one ad, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For Meta ads use facebook/ads; for TikTok ads use tiktok/ads.