{ "openapi": "3.0.1", "info": { "title": "Meta Ad Creative Analyzer — Motion Alternative", "description": "Analyze public Meta Ad Library creatives for known advertisers. Export grouped concepts, hooks, headline variants, CTA and media mixes, observed run lengths, and source ad links for competitor creative research.", "version": "0.0", "x-build-id": "eKFNdfGeSqlMw1HcL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~motion-ads-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-motion-ads-alternative", "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/khadinakbar~motion-ads-alternative/runs": { "post": { "operationId": "runs-sync-khadinakbar-motion-ads-alternative", "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/khadinakbar~motion-ads-alternative/run-sync": { "post": { "operationId": "run-sync-khadinakbar-motion-ads-alternative", "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": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Enter public Meta advertiser page IDs or exact advertiser names, one per line. Example: 100281786832302 or Nike. Numeric IDs are the most precise; names are resolved by the public provider. This Actor only researches named advertisers, not broad generic keywords.", "items": { "type": "string" } }, "advertiserPageIds": { "title": "Meta advertiser page IDs", "type": "array", "description": "Enter public Meta/Facebook advertiser page IDs, one per line. Use this when you know the exact advertiser identity. Example: 100281786832302. This Actor never needs a Meta login or your ad account.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Enter public advertiser names when a stable page ID is unavailable. Example: Nike. Provider name resolution can be less precise than a page ID, so review the returned advertiser field.", "items": { "type": "string" } }, "country": { "title": "Ad Library country", "type": "string", "description": "Choose the two-letter country scope used by the public Meta Ad Library provider. Example: US. Use ALL only when the provider supports a global response for the advertiser.", "default": "US" }, "activeStatus": { "title": "Ad activity status", "enum": [ "ACTIVE", "ALL", "INACTIVE" ], "type": "string", "description": "Choose active ads for current creative research, all ads for historical context, or inactive ads for completed campaigns. Example: ACTIVE. Public availability can vary by country and advertiser.", "default": "ACTIVE" }, "maxAdsPerAdvertiser": { "title": "Maximum ads per advertiser", "minimum": 1, "maximum": 250, "type": "integer", "description": "Set the maximum public ad records analyzed per advertiser. Example: 50. This bounds provider work and the number of creative-insight events that can be charged.", "default": 50 }, "maxPagesPerAdvertiser": { "title": "Maximum provider pages", "minimum": 1, "maximum": 25, "type": "integer", "description": "Set the maximum pagination pages per advertiser. Example: 5. A low value gives a faster directional report; a higher value can reveal more creative variants.", "default": 5 }, "provider": { "title": "Public-data provider route", "enum": [ "auto", "scrapeCreators", "sociaVault" ], "type": "string", "description": "Auto tries the configured public Meta Ad Library provider route and falls back on route failure. Example: auto. Select a single route only for diagnosis; provider credentials stay in Actor environment secrets.", "default": "auto" } } }, "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 } } } } } } } } } }