{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Ads Transparency Center Scraper",
    "description": "Search public advertiser records, list creatives for an advertiser or destination domain, retrieve records by ID, or find advertiser and domain suggestions.",
    "version": "0.1",
    "x-build-id": "l3CqdondOlWhdcKoA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/thenetaji~google-ads-transparency-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-thenetaji-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/thenetaji~google-ads-transparency-scraper/runs": {
      "post": {
        "operationId": "runs-sync-thenetaji-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/thenetaji~google-ads-transparency-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-thenetaji-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",
        "required": [
          "scraperType"
        ],
        "properties": {
          "scraperType": {
            "title": "Function",
            "enum": [
              "searchAdvertisers",
              "getAdvertiser",
              "searchCreatives",
              "getCreative",
              "searchSuggestions"
            ],
            "type": "string",
            "description": "Choose the workflow for this run.",
            "default": "searchAdvertisers"
          },
          "query": {
            "title": "Advertiser name",
            "type": "string",
            "description": "Name or brand to search. Required only for Search advertisers and Search suggestions."
          },
          "country": {
            "title": "Advertiser billing country",
            "type": "string",
            "description": "Two-letter country code, e.g. US or GB. Optionally narrows Search advertisers to advertisers billed in that country."
          },
          "sort_key": {
            "title": "Sort results",
            "enum": [
              "unknown",
              "revenue",
              "name",
              "creative_count",
              "impressions",
              "last_activity_date"
            ],
            "type": "string",
            "description": "For Search advertisers: relevance, revenue, name, creative count, or impressions. For Search creatives: relevance, revenue, impressions, or last activity date.",
            "default": "unknown"
          },
          "descending": {
            "title": "Descending order",
            "type": "boolean",
            "description": "Used with a non-default sort option.",
            "default": true
          },
          "report_type": {
            "title": "Transparency report",
            "enum": [
              "all",
              "political"
            ],
            "type": "string",
            "description": "Choose All or Political. This setting applies to advertiser and creative functions.",
            "default": "all"
          },
          "advertiser_id": {
            "title": "Advertiser link or ID",
            "type": "string",
            "description": "Paste the advertiser's Google Ads Transparency Center link, or just the AR... code in it. You can also get this from Search advertisers or Search suggestions."
          },
          "creative_id": {
            "title": "Creative link or ID",
            "type": "string",
            "description": "Paste the ad's Google Ads Transparency Center link, or just the CR... code in it. Used together with Advertiser link or ID for Creative details. You can also get this from Search creatives."
          },
          "domain": {
            "title": "Destination domain",
            "type": "string",
            "description": "Lists creatives linking to this domain. For Search creatives, provide this or Advertiser ID."
          },
          "ad_format": {
            "title": "Ad format",
            "enum": [
              "unknown",
              "text",
              "image",
              "video"
            ],
            "type": "string",
            "description": "Optionally restrict Search creatives to one format.",
            "default": "unknown"
          },
          "surfaces": {
            "title": "Where the ad ran",
            "type": "array",
            "description": "Optionally restrict Search creatives to ads shown on these Google products. Leave empty for all of them.",
            "items": {
              "type": "string",
              "enum": [
                "play",
                "maps",
                "search",
                "shopping",
                "youtube"
              ],
              "enumTitles": [
                "Play",
                "Maps",
                "Search",
                "Shopping",
                "YouTube"
              ]
            }
          },
          "num_advertiser_results": {
            "title": "Maximum advertiser suggestions",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum advertiser suggestions returned by Search suggestions, from 0 to 20.",
            "default": 5
          },
          "num_domain_results": {
            "title": "Maximum domain suggestions",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum domain suggestions returned by Search suggestions, from 0 to 20.",
            "default": 5
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum records saved by a list or search function. Set 0 to continue until no more records are available.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}