ScrapeCreators: Google Ad

Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions.

Tool ID: scrapecreators_google_ad

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_google_ad',
  {
    "url": "https://example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute scrapecreators_google_ad --input '{
  "url": "https://example.com"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe scrapecreators_google_ad --json for the complete live contract.

Input reference

Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions. firstShown can be null even when /v1/google/company/ads returns a date for the same ad. keep the company-list date when this field is null. When Google publishes political-ad transparency data, spend contains the currency and amount bounds, while targeting contains included and excluded age, gender, and location criteria. Targeted locations include their Google criterion ID, display name, full name, and country codes. Optional fields are null when Google does not publish them. regionStats and platformImpressions use lower and upper impression bounds. Variations are best-effort, omit unparseable entries, and have creative-type-dependent fields. image creatives can expose an images array. Text extraction uses OCR, so accuracy may vary.

Name	Type	Required	Default	Details
`payload.url`	`string`	Yes	—	The url of the ad
`payload.cache_max_age`	`"1d" \| "3d" \| "7d" \| "14d" \| "30d"`	No	—	If we have a response in the cache that is this many days old or newer, return the cached response. Otherwise, scrape a live result. See the Caching page for details. Allowed: `1d`, `3d`, `7d`, `14d`, `30d`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`unknown`	Yes	—	Provider response payload.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.02 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation