{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Ads Transparency Scraper: Competitor Ads & New Ad Alerts",
    "description": "Google Ads Transparency Center (Google Ad Library) scraper and API. Export any advertiser's Search, image and YouTube ads by brand, domain or advertiser ID, with first and last shown dates and countries. Schedule it with alerts to get only new and stopped ads each run. $1.50 per 1,000 ads.",
    "version": "1.4",
    "x-build-id": "7KccroHeAkNOyJG1S"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crunchy_galaxy_qcr~google-ads-transparency-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crunchy_galaxy_qcr-google-ads-transparency-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/crunchy_galaxy_qcr~google-ads-transparency-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crunchy_galaxy_qcr-google-ads-transparency-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/crunchy_galaxy_qcr~google-ads-transparency-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crunchy_galaxy_qcr-google-ads-transparency-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "queries": {
            "title": "Advertiser names or domains",
            "type": "array",
            "description": "Who to look up, one per line. Brand names (HubSpot) are matched to an advertiser. A domain (nike.com) or a full website URL (https://www.nike.com/us/) is a domain search: ads that point at that site. That is the same search as the Domains field. An adstransparency.google.com advertiser link, or a bare AR id, selects that advertiser. A domain-search link (?domain=) is read as that domain, using the Region, format, and dates below rather than the dates in the link. A single-ad link in this box still selects the advertiser, up to the ad cap. Use Transparency Center links to fetch one ad and to keep the region, format, and dates from the link. Invalid lines are skipped and not charged.",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "title": "Exact domains (optional)",
            "type": "array",
            "description": "Optional. Same domain search as a domain typed in Advertiser names, for when you want domains kept apart from brand names. One per line, such as nike.com. https:// and www. are removed. The domain is only a search term sent to the Ads Transparency Center. The website is not opened. Local hosts and IP addresses are skipped. A Transparency Center link pasted here is read the same way as in Advertiser names, so a single-ad link still selects the advertiser. Put that link in Transparency Center links to fetch one ad.",
            "items": {
              "type": "string"
            }
          },
          "advertiserIds": {
            "title": "Advertiser IDs",
            "type": "array",
            "description": "Google advertiser IDs: AR followed by about 20 digits (for example AR01614014350098432001). You can paste the advertiser page URL. A single-ad URL pasted here still selects the advertiser, not one ad. Invalid IDs are skipped and not charged.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Transparency Center links",
            "type": "array",
            "description": "Optional. Paste links copied from https://adstransparency.google.com. An advertiser page (/advertiser/AR…) selects that advertiser. A domain search (?domain=nike.com) is the same domain search as typing the domain. A single ad (/advertiser/AR…/creative/CR…) returns that ad only, and only when it is still among the newest 400 ads Google lists for that advertiser under the filters (10 pages). If it is not found, nothing is charged for it. The link is parsed locally. It is not opened, and redirects are not followed. Links with a password, a port, an IP address, or any other host are skipped and not requested. Region, format, and dates in the link apply only when those filters are left on their defaults. This actor does not apply a platform filter (Search, YouTube, Shopping, Maps, Play) from the link.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "region": {
            "title": "Region",
            "enum": [
              "anywhere",
              "US",
              "GB",
              "CA",
              "AU",
              "DE",
              "FR",
              "ES",
              "IT",
              "NL",
              "IE",
              "PL",
              "SE",
              "IN",
              "JP",
              "SG",
              "AE",
              "BR",
              "MX",
              "NZ",
              "ZA"
            ],
            "type": "string",
            "description": "Only return ads shown in this country.",
            "default": "anywhere"
          },
          "format": {
            "title": "Ad format",
            "enum": [
              "ALL",
              "TEXT",
              "IMAGE",
              "VIDEO"
            ],
            "type": "string",
            "description": "Only return ads of this format.",
            "default": "ALL"
          },
          "dateFrom": {
            "title": "Shown on or after",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}",
            "type": "string",
            "description": "Only keep ads whose last-shown date is on or after this date (YYYY-MM-DD)."
          },
          "dateTo": {
            "title": "Shown on or before",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}",
            "type": "string",
            "description": "Only keep ads whose first-shown date is on or before this date (YYYY-MM-DD)."
          },
          "maxAdsPerAdvertiser": {
            "title": "Max ads per advertiser",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop paging an advertiser once this many ads are collected. Ads come newest first. The form shows 50 so a first run stays small. An API call that omits this field uses 200. Allowed range 1-100,000; out-of-range values are clamped.",
            "default": 200
          },
          "extractAdText": {
            "title": "Extract text-ad copy",
            "type": "boolean",
            "description": "For TEXT ads, fetch the preview and pull out the headline, display URL and description. This adds one request per text ad, so it is slower.",
            "default": false
          },
          "includeRegionDetails": {
            "title": "Include per-region details",
            "type": "boolean",
            "description": "Make one extra lookup per ad to get the countries it ran in, first/last shown dates per country and (EU only) impression ranges.",
            "default": false
          },
          "previousRunDatasetId": {
            "title": "Previous run dataset ID (change tracking)",
            "type": "string",
            "description": "The dataset ID of an earlier run with the same inputs. The run then outputs NEW_AD and STOPPED_AD change records. Schedule this daily to get competitor ad alerts."
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Parallel requests. Keep this low to stay polite and avoid blocks.",
            "default": 4
          },
          "proxyCountry": {
            "title": "Proxy country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Country of the residential proxy (2-letter ISO code, e.g. US, GB, DE).",
            "default": "US"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}