{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Ads Scraper · Transparency Center · $1.6/1K",
    "description": "Get public Google Ads Transparency Center ads and advertiser summaries by domain, advertiser ID or name for competitor ad research and creative review. Returns formats, dates, days served, previews and advertiser identity. No login. $1.6/1K ads.",
    "version": "0.1",
    "x-build-id": "JvGMFNvtcAABdIn4P"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/mlg14~google-ads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-mlg14-google-ads-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/mlg14~google-ads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-mlg14-google-ads-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/mlg14~google-ads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-mlg14-google-ads-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": "Search terms",
            "type": "array",
            "description": "Advertiser names or domains to resolve to advertisers and their public ads. Example: [\"nike\"]. Use when you do not know the advertiser ID; see maxAdvertisersPerQuery.",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "title": "Exact domains",
            "type": "array",
            "description": "Destination domains to search exactly. Example: [\"example.com\"]. Use to see every advertiser promoting a site; leave empty if you use advertiserIds or queries.",
            "items": {
              "type": "string"
            }
          },
          "advertiserIds": {
            "title": "Advertiser IDs",
            "type": "array",
            "description": "Public advertiser IDs starting with AR, from Transparency Center URLs. Example: [\"AR16735076323512287233\"]. Use for exact, fastest lookups; the default is the prefilled sample ID, so replace it for your target.",
            "default": [
              "AR16735076323512287233"
            ],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Transparency Center advertiser or creative URLs, or URLs containing a domain or query parameter. Example: https://adstransparency.google.com/advertiser/AR16735076323512287233. Leave empty to use IDs, domains or queries.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "resultType": {
            "title": "Result type",
            "enum": [
              "ads",
              "advertisers"
            ],
            "type": "string",
            "description": "What each dataset row is. Allowed values: ads, advertisers. Example: advertisers for one summary per advertiser. Use ads (default) for individual creatives.",
            "default": "ads"
          },
          "region": {
            "title": "Region",
            "enum": [
              "US",
              "GB",
              "CA",
              "AU",
              "DE",
              "FR",
              "IN",
              "BR",
              "JP",
              "IT",
              "ES",
              "NL",
              "MX",
              "SG",
              "ZA",
              "ANYWHERE"
            ],
            "type": "string",
            "description": "Country where ads were shown. Allowed values: US, GB, CA, AU, DE, FR, IN, BR, JP, IT, ES, NL, MX, SG, ZA, ANYWHERE. Example: GB. Use ANYWHERE for all available regions.",
            "default": "US"
          },
          "platforms": {
            "title": "Platforms",
            "type": "array",
            "description": "Limit ads to these surfaces. Allowed values: SEARCH, YOUTUBE, SHOPPING, MAPS, PLAY. Example: [\"YOUTUBE\"]. Leave empty for all surfaces.",
            "items": {
              "type": "string",
              "enum": [
                "SEARCH",
                "YOUTUBE",
                "SHOPPING",
                "MAPS",
                "PLAY"
              ]
            },
            "default": []
          },
          "adFormat": {
            "title": "Format",
            "enum": [
              "ALL",
              "TEXT",
              "IMAGE",
              "VIDEO"
            ],
            "type": "string",
            "description": "Return only this creative format. Allowed values: ALL, TEXT, IMAGE, VIDEO. Example: VIDEO for video ads only. Use ALL (default) for every format.",
            "default": "ALL"
          },
          "startDate": {
            "title": "Shown on or after",
            "type": "string",
            "description": "Keep ads whose activity overlaps this date or later, format YYYY-MM-DD. Example: 2026-01-01. Leave empty for no start limit."
          },
          "endDate": {
            "title": "Shown on or before",
            "type": "string",
            "description": "Keep ads whose activity overlaps this date or earlier, format YYYY-MM-DD. Example: 2026-06-30. Leave empty for no end limit."
          },
          "maxAdsPerSearch": {
            "title": "Ads per target",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum ads read for each advertiser or domain and each selected platform. Example: 40. Keep it small for quick runs; raise it for full advertiser exports.",
            "default": 100
          },
          "maxAdvertisersPerQuery": {
            "title": "Advertisers per search term",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Maximum suggested advertiser accounts to inspect for each search term in queries (at most 10). Example: 3. Use a low value for precise names; leave default 5 otherwise.",
            "default": 5
          },
          "maxItems": {
            "title": "Total results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many dataset rows across all targets. Example: 40. Set 0 for no total cap; keep it small so agents get bounded results.",
            "default": 100
          },
          "includeDetails": {
            "title": "Full creative details",
            "type": "boolean",
            "description": "Add all creative variations and country reach to each ad, with one extra request per ad. Allowed values: true or false. Example: true for reach analysis. Leave false (default) for faster, cheaper runs.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy settings. The scraper begins with datacenter access and escalates on blocks.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}