{ "openapi": "3.0.1", "info": { "title": "Meta Ads Prospect Finder: Advertisers With Leaky Sites", "description": "Pair active Meta ads with an HTTP homepage check for forms, booking links and visible tracking. Get prioritised agency prospects with evidence and review prompts. A screening score, not measured conversion loss.", "version": "0.1", "x-build-id": "kWck6Z7hQ42RledUb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fractionalhqforyou~advertisers-with-leaky-sites/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fractionalhqforyou-advertisers-with-leaky-sites", "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/fractionalhqforyou~advertisers-with-leaky-sites/runs": { "post": { "operationId": "runs-sync-fractionalhqforyou-advertisers-with-leaky-sites", "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/fractionalhqforyou~advertisers-with-leaky-sites/run-sync": { "post": { "operationId": "run-sync-fractionalhqforyou-advertisers-with-leaky-sites", "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": "Company domains or Facebook pages", "type": "string", "description": "One per line: a company domain (oddbox.co.uk) or a Facebook page URL (https://www.facebook.com/OddboxLDN). A domain is opened once to find the Facebook page in its footer. Leave everything empty for a demo dataset that charges nothing." }, "searchTerm": { "title": "Or search Google Maps for", "type": "string", "description": "A category as you would type it into Google Maps: for example dentist or kitchen fitter. Used only when the domains box is empty. Runs the Google Maps scraper with its contacts add-on, billed to your own Apify account on top." }, "location": { "title": "Where", "type": "string", "description": "A town or city for the Maps search, such as Bolton in the UK." }, "maxPlaces": { "title": "How many Maps results to check", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on businesses taken from the Maps search. Hard limit 500.", "default": 20 }, "country": { "title": "Ad Library country", "type": "string", "description": "Two-letter ISO code for the Ad Library filter, or ALL. Only ads shown in this country count.", "default": "GB" }, "maxAdsPerCompany": { "title": "Active ads to read per company", "minimum": 10, "maximum": 100, "type": "integer", "description": "Cap on ads read from the Ad Library for each page, which bounds the wrapped run's cost. Five active ads already means SCALING, so 30 is plenty. Minimum 10, the wrapped Actor's floor.", "default": 30 }, "minScore": { "title": "Only keep companies scoring at least", "minimum": 0, "maximum": 100, "type": "integer", "description": "Filters the saved rows, not the work. 60 and above is HOT. Every company checked is charged for whether or not it clears this.", "default": 0 }, "watchKey": { "title": "Watch key", "type": "string", "description": "Names the snapshot this run compares against. Run the same list under the same key each week and a company whose ads have stopped shows as DORMANT.", "default": "default" }, "records": { "title": "Company records you already have (optional)", "type": "array", "description": "Objects with name, domain or website, fb_page, and optionally ads (raw Ad Library items) and site (a previous website check). Anything supplied is not fetched again." } } }, "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 } } }, "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 } } } } } } } } } }