{ "openapi": "3.0.1", "info": { "title": "Shopify App Detector: Tech Stack, Pixels & Theme", "description": "Profiles any Shopify store: every installed app with evidence (400+ known apps in 30 categories plus any app block), pixels, theme, catalog, estimated monthly app spend, missing categories and contacts. Filter to stores using or lacking an app; track installs/removals. Domains or a dataset.", "version": "0.2", "x-build-id": "R6BbnSj8bHcqhJPeY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/centorprat~shopify-app-detector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-centorprat-shopify-app-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/centorprat~shopify-app-detector/runs": { "post": { "operationId": "runs-sync-centorprat-shopify-app-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/centorprat~shopify-app-detector/run-sync": { "post": { "operationId": "run-sync-centorprat-shopify-app-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": { "domains": { "title": "🔗 Store domains", "type": "array", "description": "The Shopify stores to profile, e.g. [\"allbirds.com\", \"gymshark.com\"]. Storefront domains, not myshopify admin URLs. Non-Shopify sites are skipped for free.", "items": { "type": "string" } }, "datasetId": { "title": "🔗 Dataset with store URLs (optional)", "type": "string", "description": "Pick (or paste the ID of) any dataset whose rows contain store URLs or domains (url, website, domain, link fields, or Google organicResults). Read-only. Use this to profile the output of a store finder, ad-library or Google Search run, then keep only the stores that use (or lack) an app with the filters below." }, "requireApps": { "title": "🎯 Keep stores that use any of these apps (optional)", "type": "array", "description": "Return only stores running at least one of these apps, e.g. [\"Klaviyo\"] or [\"Recharge\", \"Skio\"]. Matches app names or Shopify app handles, case-insensitive. Use it to build a list of a competitor's customers from any store list.", "items": { "type": "string" } }, "excludeApps": { "title": "🚫 Drop stores that use any of these apps (optional)", "type": "array", "description": "Leave out stores running any of these apps, e.g. your own app's name so you only see prospects.", "items": { "type": "string" } }, "missingCategories": { "title": "🕳️ Keep stores MISSING these app categories (optional)", "type": "array", "description": "Return only stores with no app in these categories, e.g. [\"loyalty\"] or [\"reviews\", \"emailSms\"]. Category keys: reviews, emailSms, upsell, loyalty, support, subscriptions, search, bnpl, returns, shipping, analytics, abTesting, personalization, pageBuilder, consent, accessibility, affiliates, ugcVideo, productOptions, preorder, wishlist, giftCards, localization, seo, fraud, forms, quizzes, channels, b2b, discounts, storefrontUx.", "items": { "type": "string" } }, "requireCategories": { "title": "✅ Keep stores that HAVE these app categories (optional)", "type": "array", "description": "Return only stores with at least one app in each of these categories, e.g. [\"subscriptions\"]. Same keys as above.", "items": { "type": "string" } }, "minEstimatedAppSpend": { "title": "💵 Minimum estimated app spend (USD/month, optional)", "minimum": 0, "type": "integer", "description": "Return only stores whose ESTIMATED monthly app spend is at least this much, e.g. 500 for stores that clearly pay for software. The estimate comes from public plan prices x catalog size; it is not the store's actual bill." }, "storeCountries": { "title": "Store countries (optional)", "type": "array", "description": "Keep only stores based in these countries (two-letter codes from the store's Shopify settings), e.g. [\"US\", \"CA\"]. Checked before the full profile, so filtered-out stores are free.", "items": { "type": "string" } }, "historyStore": { "title": "📈 Track changes: history store (optional)", "type": "string", "description": "Pick (or create) a key-value store to keep a snapshot of each store's stack. Every later run reports what changed since the previous one: apps installed and removed, pixels added and removed, theme switches, catalog growth. Schedule the Actor weekly on your competitor or prospect list." }, "onlyChanged": { "title": "Return only stores whose stack changed", "type": "boolean", "description": "With a history store: return only stores where an app, pixel or theme changed since the last run (plus stores seen for the first time). Ideal for scheduled alert runs with a webhook.", "default": false }, "includeEvidence": { "title": "Include evidence per app", "type": "boolean", "description": "Attach the proof for each detected app (the app block, script URL or widget that revealed it). Turn off for smaller rows.", "default": true }, "maxItems": { "title": "Max rows to read from the dataset", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Safety cap when reading a dataset.", "default": 2000 }, "concurrency": { "title": "Parallel store audits", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many stores are profiled at once.", "default": 8 }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "If set, the results are POSTed here as JSON (Zapier / Make / n8n / your CRM). With change tracking, the payload starts with a short list of what changed per store." } } }, "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 } } } } } } } } } }