> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape Google ads (Ads Transparency Center) > Returns an advertiser's Google ads (Search, YouTube, Display, Shopping, Maps, Play) from the Google Ads Transparency Center for competitor analysis: per ad `creativeId`, `advertiserId`/`advertiserName`, `format` (text/image/video), `firstShown`, `lastShown`, `daysShown`, `matchedDomain`, the preview (`imageUrl` with size, or `previewUrl`), `googleCreativeId`, `googleCustomerId`, `adGroupId` and `adUrl`. Pick ads by `advertiser` (name or id) or `domain`; filter with `region`, `platform`, `format` and `date_from`/`date_to`. `include_details` adds per-region reach and targeting, `include_preview` the ad's texts and YouTube video. Collects up to `max_results` (continue with `page_token`); billed one unit per page of up to 100 ads, plus one per detail and per preview fetched (`callUnits`). ## OpenAPI ````yaml /api-reference/openapi.json post /ads/google-ads-transparency openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Documented here: page-source extraction, Google SERP scraping, image fetch, and the dedicated plugin endpoints (search engines, marketplaces, reviews, travel, social and more). All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /ads/google-ads-transparency: post: tags: - Plugins summary: Scrape Google ads (Ads Transparency Center) description: >- Returns an advertiser's Google ads (Search, YouTube, Display, Shopping, Maps, Play) from the Google Ads Transparency Center for competitor analysis: per ad `creativeId`, `advertiserId`/`advertiserName`, `format` (text/image/video), `firstShown`, `lastShown`, `daysShown`, `matchedDomain`, the preview (`imageUrl` with size, or `previewUrl`), `googleCreativeId`, `googleCustomerId`, `adGroupId` and `adUrl`. Pick ads by `advertiser` (name or id) or `domain`; filter with `region`, `platform`, `format` and `date_from`/`date_to`. `include_details` adds per-region reach and targeting, `include_preview` the ad's texts and YouTube video. Collects up to `max_results` (continue with `page_token`); billed one unit per page of up to 100 ads, plus one per detail and per preview fetched (`callUnits`). operationId: google_ads_transparency_ads_google_ads_transparency_post parameters: - name: advertiser in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Advertiser to pull ads for: a name (e.g. 'Nike') - resolved to the best-matching advertiser, reported in `advertisersUsed` (a single brand name no advertiser is named like falls back to its domain) - or an advertiser id ('AR16735076323512287233'). Comma-separate up to 10. Pass `advertiser` or `domain`. title: Advertiser description: >- Advertiser to pull ads for: a name (e.g. 'Nike') - resolved to the best-matching advertiser, reported in `advertisersUsed` (a single brand name no advertiser is named like falls back to its domain) - or an advertiser id ('AR16735076323512287233'). Comma-separate up to 10. Pass `advertiser` or `domain`. - name: domain in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Website the ads point to, e.g. 'nike.com' (ads of every advertiser for that domain). title: Domain description: >- Website the ads point to, e.g. 'nike.com' (ads of every advertiser for that domain). - name: region in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Where the ads were shown: a 2-letter country code ('US', 'DE'), a comma list of them, or 'anywhere' (default). title: Region description: >- Where the ads were shown: a 2-letter country code ('US', 'DE'), a comma list of them, or 'anywhere' (default). - name: platform in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only ads shown on these platforms (comma list): search, youtube, maps, play, shopping. title: Platform description: >- Only ads shown on these platforms (comma list): search, youtube, maps, play, shopping. - name: format in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Only one ad format: text, image or video.' title: Format description: 'Only one ad format: text, image or video.' - name: date_from in: query required: false schema: anyOf: - type: string - type: 'null' description: Only ads shown on or after this date (YYYY-MM-DD). title: Date From description: Only ads shown on or after this date (YYYY-MM-DD). - name: date_to in: query required: false schema: anyOf: - type: string - type: 'null' description: Only ads shown on or before this date (YYYY-MM-DD). title: Date To description: Only ads shown on or before this date (YYYY-MM-DD). - name: sort in: query required: false schema: type: string description: 'Order of the ads: ''last_shown'' (most recently shown first).' default: last_shown title: Sort description: 'Order of the ads: ''last_shown'' (most recently shown first).' - name: max_results in: query required: false schema: type: integer description: >- Ads to collect, 1-1000. Pages of up to 100 are fetched as needed; each page is billed one unit. default: 100 title: Max Results description: >- Ads to collect, 1-1000. Pages of up to 100 are fetched as needed; each page is billed one unit. - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Continue a previous call: its `nextPageToken`.' title: Page Token description: 'Continue a previous call: its `nextPageToken`.' - name: include_details in: query required: false schema: type: boolean description: >- Add `details` per ad: regions shown with first/last date (plus impressions per platform for EU regions), EU reach, disclosed targeting and all preview variations. One unit per ad, for up to 300 ads per call. default: false title: Include Details description: >- Add `details` per ad: regions shown with first/last date (plus impressions per platform for EU regions), EU reach, disclosed targeting and all preview variations. One unit per ad, for up to 300 ads per call. - name: include_preview in: query required: false schema: type: boolean description: >- Add `preview` per ad: what it shows - headline, description and display URL of text ads, product title and merchant of shopping ads, image URLs, the YouTube video of video ads. One unit per ad that has a preview script, for up to 40 ads per call. Search text ads often exist only as an image (`imageUrl`). default: false title: Include Preview description: >- Add `preview` per ad: what it shows - headline, description and display URL of text ads, product title and merchant of shopping ads, image URLs, the YouTube video of video ads. One unit per ad that has a preview script, for up to 40 ads per call. Search text ads often exist only as an image (`imageUrl`). responses: '200': description: JSON with a `creatives` array. content: application/json: schema: {} '400': description: Invalid parameters. '404': description: No advertiser matches the name, or no ads match the filters. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked on every attempt, an unusable answer, or no answer in time. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.