{ "openapi": "3.0.1", "info": { "title": "Competitor Ad Footprint: Google + Meta Ads Checker", "description": "Is this company advertising? See one row per domain from the public Google Ads Transparency Center and Meta Ad Library: ad counts, formats, platforms, first/last seen, regions, sample ads and a 0-100 footprint score. Monitor mode flags changes. No login.", "version": "0.1", "x-build-id": "wwtcQcU4fx4WI79yF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/transparent_meteorite~ad-footprint-by-domain/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-transparent_meteorite-ad-footprint-by-domain", "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/transparent_meteorite~ad-footprint-by-domain/runs": { "post": { "operationId": "runs-sync-transparent_meteorite-ad-footprint-by-domain", "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/transparent_meteorite~ad-footprint-by-domain/run-sync": { "post": { "operationId": "run-sync-transparent_meteorite-ad-footprint-by-domain", "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": { "domains": { "title": "Domains", "type": "array", "description": "Company domains to check, one per line (for example \"hubspot.com\"). Website URLs work too; the domain is taken from them.", "default": [ "hubspot.com" ], "items": { "type": "string" } }, "startUrls": { "title": "Website URLs (paste)", "type": "array", "description": "Paste company website URLs (homepages, landing pages). Each URL's domain is checked once. Same as Domains, in the format other actors use.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "brandNames": { "title": "Brand names (optional, same order as Domains)", "type": "array", "description": "Override the brand keyword used to find the advertiser in the Meta Ad Library, in the same order as Domains (for example \"Blue Bottle Coffee\" for bluebottlecoffee.com). Leave empty to use the domain name.", "items": { "type": "string" } }, "sources": { "title": "Ad libraries", "type": "array", "description": "Which public ad libraries to check. LinkedIn is reported as unavailable (its robots.txt forbids automated access), with a link to check by hand.", "items": { "type": "string", "enum": [ "google", "meta", "linkedin" ], "enumTitles": [ "Google Ads Transparency Center", "Meta Ad Library", "LinkedIn Ad Library (link only)" ] }, "default": [ "google", "meta", "linkedin" ] }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code where the ads were shown (US, GB, DE, ...), or ANY for all countries.", "default": "US" }, "includeAdSamples": { "title": "Ad samples per library", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many sample ads to attach per library (text, dates, preview link). The first 3 per library are included in the domain price; more cost the ad-sample event each.", "default": 3 }, "maxItems": { "title": "Max domains", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many domains.", "default": 100 }, "onlyNew": { "title": "Only changed since last run (monitor)", "type": "boolean", "description": "Monitor mode: output (and charge) only domains whose ad counts or newest ads changed since the last run that used the same state store. The first run outputs everything.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that remembers the last snapshot per domain for monitor mode. Use one name per watch list.", "default": "ad-footprint-state" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Meta rate-limits datacenter IPs, so residential Apify Proxy is the default. Google is called directly and falls back to this proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "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 } } } } } } } } } }