{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Ads Transparency Scraper | Ad Text + Domain Check",
    "description": "Scrape the Google Ads Transparency Center by domain, advertiser or URL. Get each ad's dates and format, Search ad copy as text (headline, description, sitelinks), YouTube links for video ads, a bulk \"does this domain run Google Ads?\" check, and new/stopped ad monitoring.",
    "version": "0.1",
    "x-build-id": "FS8VaocGS9LYFEdO6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zrk1212~google-ads-transparency-ad-copy/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zrk1212-google-ads-transparency-ad-copy",
        "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/zrk1212~google-ads-transparency-ad-copy/runs": {
      "post": {
        "operationId": "runs-sync-zrk1212-google-ads-transparency-ad-copy",
        "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/zrk1212~google-ads-transparency-ad-copy/run-sync": {
      "post": {
        "operationId": "run-sync-zrk1212-google-ads-transparency-ad-copy",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "ads",
              "domainCheck"
            ],
            "type": "string",
            "description": "ads: one row per ad. domainCheck: one row per domain saying whether it runs Google Ads, how many, which formats and when last shown.",
            "default": "ads"
          },
          "domains": {
            "title": "Domains",
            "type": "array",
            "description": "Advertised websites, for example nike.com or https://www.nike.com/us. We search ads that point to this domain.",
            "items": {
              "type": "string"
            }
          },
          "advertiserIds": {
            "title": "Advertiser IDs",
            "type": "array",
            "description": "Google advertiser IDs, for example AR16735076323512287233 (Nike, Inc.). Find them in the Transparency Center URL. Ignored in domainCheck mode.",
            "items": {
              "type": "string"
            }
          },
          "advertiserNames": {
            "title": "Advertiser names",
            "type": "array",
            "description": "Advertiser names, for example Nike, Inc. or GEICO. Resolved with Google's own advertiser search. An exact name match wins, so paste the name exactly as shown in the Transparency Center, or use the advertiser ID. Ignored in domainCheck mode.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Transparency Center URLs",
            "type": "array",
            "description": "Advertiser pages (/advertiser/AR...), domain searches (/?domain=nike.com) or single ads (/advertiser/AR.../creative/CR...). The region in the URL wins over the region field.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxAdvertisersPerName": {
            "title": "Advertisers per name",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many matching advertisers to take per advertiser name (exact match first, then by ad count).",
            "default": 1
          },
          "region": {
            "title": "Region",
            "enum": [
              "anywhere",
              "US",
              "GB",
              "CA",
              "AU",
              "DE",
              "FR",
              "ES",
              "IT",
              "NL",
              "BR",
              "MX",
              "IN",
              "JP",
              "PT",
              "IE",
              "NZ",
              "ZA",
              "SG",
              "AT",
              "BE",
              "CH",
              "SE",
              "NO",
              "DK",
              "FI",
              "PL",
              "CZ",
              "GR",
              "TR",
              "RO",
              "HU",
              "UA",
              "IL",
              "AE",
              "SA",
              "EG",
              "NG",
              "KE",
              "AR",
              "CL",
              "CO",
              "PE",
              "KR",
              "TW",
              "HK",
              "TH",
              "VN",
              "ID",
              "MY",
              "PH",
              "PK",
              "BD",
              "RU",
              "BG",
              "HR",
              "SK",
              "LT",
              "LV",
              "EE"
            ],
            "type": "string",
            "description": "Country where the ads were shown, or anywhere for all countries.",
            "default": "US"
          },
          "adFormats": {
            "title": "Ad formats",
            "type": "array",
            "description": "Keep only these formats. One format is filtered by Google (faster). Two formats run two filtered searches. Ignored in domainCheck mode.",
            "items": {
              "type": "string",
              "enum": [
                "text",
                "image",
                "video"
              ],
              "enumTitles": [
                "Text (Search ads)",
                "Image",
                "Video"
              ]
            },
            "default": [
              "text",
              "image",
              "video"
            ]
          },
          "dateFrom": {
            "title": "Shown from",
            "type": "string",
            "description": "Only ads shown at any time in this range (overlap). Sent to Google as a filter. Ranges more than about 12 months back may return nothing. Ignored in domainCheck mode."
          },
          "dateTo": {
            "title": "Shown until",
            "type": "string",
            "description": "End of the date range, see Shown from. Ignored in domainCheck mode."
          },
          "landingDomain": {
            "title": "Landing domain",
            "type": "string",
            "description": "Only ads that send traffic to this domain. With advertiser IDs or names it means this advertiser's ads for this site. Ignored in domainCheck mode."
          },
          "maxAdsPerTarget": {
            "title": "Max ads per target",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum number of ads per domain, advertiser or URL.",
            "default": 200
          },
          "includeAdText": {
            "title": "Extract ad text",
            "type": "boolean",
            "description": "Extract the ad copy (headline, description, display URL, sitelinks) as text, from Google's preview data or by reading the ad screenshot. Charged only for ads where text was found. Turn off for the cheapest metadata-only run. Ignored in domainCheck mode.",
            "default": true
          },
          "includeDetails": {
            "title": "Include ad details",
            "type": "boolean",
            "description": "One extra request per ad: all regions where the ad was shown with last shown date per region, number of variations, and EU impression ranges where Google publishes them. No extra charge, but slower. Ignored in domainCheck mode.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor key",
            "type": "string",
            "description": "Turn on monitor mode with a name for this watch list, for example competitors-us. Each run compares with the previous run under the same key and outputs only new and stopped ads. The first run lists the current ads as baseline. Ignored in domainCheck mode."
          },
          "stoppedAfterDays": {
            "title": "Stopped after days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Monitor mode: an ad counts as stopped when Google's last shown date is older than this many days.",
            "default": 7
          },
          "useResidentialFallback": {
            "title": "Use residential proxy",
            "type": "boolean",
            "description": "Google blocks direct connections from cloud servers for this site, so search calls go through Apify residential proxy at no extra charge to you. Turn off to connect directly: if Google blocks the connection, the run stops with a rate-limit error row and keeps the partial results.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}