{ "openapi": "3.0.1", "info": { "title": "Competitor Ads Checker: Meta, LinkedIn & Google Ad Library", "description": "Check if companies run ads on Google, Meta (Facebook & Instagram) and LinkedIn. Paste domains, get one row per domain: active, not found or unknown per platform, ad count, first/last seen, ad IDs, ad library links and a company profile. Qualify leads and track competitor ads. MCP-ready.", "version": "0.1", "x-build-id": "51nvNjEEycA1FqfW2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/doesaiknow~competitor-ads-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-doesaiknow-competitor-ads-checker", "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/doesaiknow~competitor-ads-checker/runs": { "post": { "operationId": "runs-sync-doesaiknow-competitor-ads-checker", "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/doesaiknow~competitor-ads-checker/run-sync": { "post": { "operationId": "run-sync-doesaiknow-competitor-ads-checker", "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": [ "domains" ], "properties": { "domains": { "title": "Company domains or website URLs", "minItems": 1, "maxItems": 500, "type": "array", "description": "Up to 500 company domains or website URLs per run, for example \"hubspot.com\" or \"https://www.pipedrive.com/pricing\". Each entry is normalized (lowercase, no https://, no www., no path) and the same domain listed twice is checked once. Entries that are not valid domains come back as rows with status \"invalid_input\" and are not charged.", "items": { "type": "string" } }, "platforms": { "title": "Ad libraries to check", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Which ad libraries to check. Default: \"google\" (Google Ads Transparency Center, ads shown in the last 7 days, any region) and \"meta\" (Meta Ad Library for Facebook & Instagram, ads with status ACTIVE). LinkedIn (beta) — add \"linkedin\" to platforms to also check the LinkedIn Ad Library (ads that ran in the last 30 days); it is checked when the company website links its LinkedIn page, otherwise LinkedIn is \"unknown\". A domain is charged only when every selected platform gets a clear answer, so adding LinkedIn can turn a row into \"partial\" (not charged). A platform you leave out is null in the output. At least one is required.", "items": { "type": "string", "enum": [ "google", "meta", "linkedin" ], "enumTitles": [ "Google Ads Transparency Center", "Meta Ad Library (Facebook & Instagram)", "LinkedIn Ad Library (beta)" ] }, "default": [ "google", "meta" ] }, "includeSampleAds": { "title": "Include sample ads", "type": "boolean", "description": "Add up to N sample ads per platform with ad ID, ad library link, first/last seen, format and creative link when the library returns one. Ad text is not included. Every platform with ads always gets at least one ad as evidence, even when this is off.", "default": true }, "maxSampleAdsPerPlatform": { "title": "Sample ads per platform", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many sample ads to include per platform (0–10).", "default": 3 }, "includeCompanyProfile": { "title": "Include company profile", "type": "boolean", "description": "Add a light company profile: name, website, LinkedIn page, industry, employee range and HQ country. It comes from the company's LinkedIn page when LinkedIn is checked and the page links back to the domain, otherwise from the homepage. It never adds an extra paid lookup and never includes people.", "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 } } } } } } } } } }