{ "openapi": "3.0.1", "info": { "title": "Ghost Kitchen & Virtual Brand Intelligence", "description": "Turn supplied business listings into traceable investigation actions. Review operating conflicts, freshness, counterevidence and next useful facts for up to 250 observations. No live discovery or ownership verdict. $0.10 per completed bundle.", "version": "0.7", "x-build-id": "G3psyn2U6KDm7pbmD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/critd~ghost-kitchen-detector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-critd-ghost-kitchen-detector", "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/critd~ghost-kitchen-detector/runs": { "post": { "operationId": "runs-sync-critd-ghost-kitchen-detector", "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/critd~ghost-kitchen-detector/run-sync": { "post": { "operationId": "run-sync-critd-ghost-kitchen-detector", "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": { "mode": { "title": "Analysis Mode", "enum": [ "analyze_supplied" ], "type": "string", "description": "The only production mode is analyze_supplied. Retired location-scanning inputs remain recognizable only for a no-charge migration result." }, "market": { "title": "Declared Market Context", "required": [ "label", "countryCode" ], "type": "object", "description": "Buyer-declared context for interpreting the supplied cohort. It is not a coverage, demand, share, or absence claim.", "properties": { "label": { "title": "Market Label", "type": "string", "description": "A buyer-readable market label such as Chicago, IL.", "editor": "textfield", "minLength": 1, "maxLength": 200 }, "countryCode": { "title": "Country Code", "type": "string", "description": "Two-letter country context. This value does not establish cohort coverage.", "editor": "textfield", "pattern": "^[A-Za-z]{2}$" } }, "additionalProperties": false }, "rightsBasis": { "title": "Rights Basis", "enum": [ "first_party", "licensed_for_analysis", "otherwise_authorized" ], "type": "string", "description": "Your declared authority to submit these business-listing observations for this analysis. Uploading data is not blanket permission for another use. The fictional prefill uses otherwise_authorized; choose the basis that actually applies to your data." }, "freshnessHorizonDays": { "title": "Freshness Horizon (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Classify buyer-supplied observation clocks against this 1-3,650 day horizon. Missing observedAt remains unknown; retrieval time never replaces it. The long fictional-example horizon is not a recommended freshness policy for your data." }, "sourceLabelDefault": { "title": "Default Source Label", "minLength": 1, "maxLength": 120, "type": "string", "description": "Optional exact source label applied only when a selected row lacks sourceLabel." }, "records": { "title": "Inline Supplied Records", "minItems": 1, "maxItems": 250, "type": "array", "description": "Start runs a three-record fictional example. Replace all sample rows with your authorized observations. To use a storage source, switch to JSON and remove the entire records property before adding source. Submit exactly one route. Over 250 records fails without truncation.", "items": { "type": "object", "additionalProperties": false, "required": [ "name", "address" ], "properties": { "name": { "title": "Business Name", "type": "string", "description": "Selected business or brand name.", "editor": "textfield", "minLength": 1, "maxLength": 300 }, "address": { "title": "Business Address", "type": "string", "description": "Selected business-location address.", "editor": "textfield", "minLength": 1, "maxLength": 600 }, "sourceLabel": { "title": "Source Label", "type": "string", "description": "Exact source identity for this observation. Required unless sourceLabelDefault is provided.", "editor": "textfield", "minLength": 1, "maxLength": 120 }, "sourceRecordId": { "title": "Source Record ID", "type": "string", "description": "Optional source-local row identifier retained for traceability.", "editor": "textfield", "maxLength": 240 }, "observedAt": { "title": "Observed At", "type": "string", "description": "Optional RFC 3339 source observation clock. It must not be in the future.", "editor": "textfield" }, "website": { "title": "Business Website", "type": "string", "description": "Optional absolute HTTP(S) business URL without credentials, query, or fragment.", "editor": "textfield", "maxLength": 500 }, "phone": { "title": "Business Phone", "type": "string", "description": "Optional business phone used only as a supplied comparison fact.", "editor": "textfield", "maxLength": 500 }, "category": { "title": "Observed Category", "type": "string", "description": "Optional supplied business category.", "editor": "textfield", "maxLength": 500 }, "declaredBrand": { "title": "Declared Brand", "type": "string", "description": "Optional supplied brand relationship; it is not independent ownership verification.", "editor": "textfield", "maxLength": 500 }, "operatingObservation": { "title": "Operating Observation", "type": "string", "description": "Optional explicit observation from this source row.", "editor": "select", "enum": [ "delivery_only", "dine_in" ], "enumTitles": [ "Delivery-only observed", "Dine-in observed" ] } } } }, "source": { "title": "Bounded Apify Storage Source", "required": [ "type" ], "type": "object", "description": "Alternatively read one file-upload KVS record, Dataset, or KVS record through bounded READ-only platform storage calls. Only mapped decision-bearing fields enter analysis or durable output.", "properties": { "type": { "title": "Source Type", "type": "string", "description": "Select exactly one supported Apify storage route.", "editor": "select", "enum": [ "file", "dataset", "keyValueStore" ], "enumTitles": [ "Uploaded file (Apify KVS URL)", "Dataset", "Key-value store record" ] }, "fileUrl": { "title": "Uploaded File", "type": "string", "description": "For type=file, select a credential-free https://api.apify.com KVS record URL. Arbitrary URLs and query tokens are rejected.", "editor": "fileupload" }, "datasetId": { "title": "Dataset ID or Name", "type": "string", "description": "For type=dataset, select a Dataset with READ access.", "editor": "resourcePicker", "resourceType": "dataset", "resourcePermissions": [ "READ" ], "maxLength": 256 }, "storeId": { "title": "Key-value Store ID or Name", "type": "string", "description": "For type=keyValueStore, select a KVS with READ access.", "editor": "resourcePicker", "resourceType": "keyValueStore", "resourcePermissions": [ "READ" ], "maxLength": 256 }, "recordKey": { "title": "Record Key", "type": "string", "description": "For type=keyValueStore, the record containing CSV, JSONL, or one JSON array.", "editor": "textfield", "maxLength": 256 }, "format": { "title": "Text Format", "type": "string", "description": "Optional declared file/KVS format. When omitted, content type, key suffix, and bounded body shape are used conservatively.", "editor": "select", "enum": [ "csv", "jsonl", "json" ], "enumTitles": [ "CSV", "JSON Lines", "JSON array" ] }, "fieldMap": { "title": "Selected Field Map", "type": "object", "description": "Map the ten supported facts to distinct top-level source fields. Name and address are required in every row; the remaining selected fields may be absent.", "editor": "json", "additionalProperties": false, "properties": { "name": { "title": "Name field", "type": "string", "description": "Source field containing the business name. Runtime uses name when omitted.", "editor": "textfield" }, "address": { "title": "Address field", "type": "string", "description": "Source field containing the business address. Runtime uses address when omitted.", "editor": "textfield" }, "sourceLabel": { "title": "Source-label field", "type": "string", "description": "Source field containing per-row source identity. Runtime uses sourceLabel when omitted.", "editor": "textfield" }, "sourceRecordId": { "title": "Source-record-id field", "type": "string", "description": "Source field containing the optional source record id. Runtime uses sourceRecordId when omitted.", "editor": "textfield" }, "observedAt": { "title": "Observed-at field", "type": "string", "description": "Source field containing the optional RFC 3339 observation clock. Runtime uses observedAt when omitted.", "editor": "textfield" }, "website": { "title": "Website field", "type": "string", "description": "Source field containing the optional business URL. Runtime uses website when omitted.", "editor": "textfield" }, "phone": { "title": "Phone field", "type": "string", "description": "Source field containing the optional business phone. Runtime uses phone when omitted.", "editor": "textfield" }, "category": { "title": "Category field", "type": "string", "description": "Source field containing the optional category. Runtime uses category when omitted.", "editor": "textfield" }, "declaredBrand": { "title": "Declared-brand field", "type": "string", "description": "Source field containing the optional declared brand. Runtime uses declaredBrand when omitted.", "editor": "textfield" }, "operatingObservation": { "title": "Operating-observation field", "type": "string", "description": "Source field containing delivery_only or dine_in when observed. Runtime uses operatingObservation when omitted.", "editor": "textfield" } } } }, "additionalProperties": false }, "demoMode": { "title": "Retired Demo Mode (inactive)", "type": "boolean", "description": "Recognized only for saved-input compatibility. It cannot activate a demo, collector, provider, billing unit, or the new analysis mode." }, "demoScenario": { "title": "Retired Demo Scenario (inactive)", "type": "string", "description": "Recognized but never executed." }, "location": { "title": "Retired Location (inactive)", "type": "string", "description": "Recognized but never collected." }, "locations": { "title": "Retired Locations (inactive)", "type": "array", "description": "Recognized but never collected.", "items": { "type": "object" } }, "batchConcurrency": { "title": "Retired Batch Concurrency (inactive)", "type": "integer", "description": "Recognized but never executed." }, "radiusMiles": { "title": "Retired Radius (inactive)", "type": "integer", "description": "Recognized but never executed." }, "cuisineFilter": { "title": "Retired Cuisine Filter (inactive)", "type": "string", "description": "Recognized but never executed." }, "maxRestaurants": { "title": "Retired Maximum Restaurants (inactive)", "type": "integer", "description": "Recognized but never executed." }, "confidenceThreshold": { "title": "Retired Confidence Threshold (inactive)", "type": "number", "description": "Recognized but never executed." }, "includeTraditionalRestaurants": { "title": "Retired Inclusion Control (inactive)", "type": "boolean", "description": "Recognized but never executed." }, "yelpApiKey": { "title": "Retired Yelp Key (inactive)", "type": "string", "description": "Recognized as an encrypted compatibility field but never read, transmitted, or emitted." } } }, "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 } } } } } } } } } }