{ "openapi": "3.0.1", "info": { "title": "Shopify Store Finder & Scraper - Find Shopify Stores by App", "description": "Find Shopify stores by the apps they use or don't use, country, category and traffic. Also a Shopify store analyzer: paste store URLs to get theme, apps, pixels and tech stack. A Shopify store scraper backed by a Shopify store database of 1M+ stores. No API key. Pay per store.", "version": "0.1", "x-build-id": "5pdEXcfmNHrgTstg7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/storeinspect~shopify-store-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-storeinspect-shopify-store-finder", "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/storeinspect~shopify-store-finder/runs": { "post": { "operationId": "runs-sync-storeinspect-shopify-store-finder", "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/storeinspect~shopify-store-finder/run-sync": { "post": { "operationId": "run-sync-storeinspect-shopify-store-finder", "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": { "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes, such as US or GB. Leave empty for every country.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "fashion", "beauty", "home", "food", "health", "electronics", "sports", "pets", "jewelry", "baby", "automotive", "outdoor", "hobby", "gifts", "books-media", "hardware", "office", "travel", "services", "events", "adult", "other" ], "type": "string", "description": "What the store sells.", "default": "" }, "apps": { "title": "Uses these apps", "type": "array", "description": "App names, such as Klaviyo, Yotpo or Recharge. Only stores that use them are returned.", "items": { "type": "string" } }, "apps_match": { "title": "App match", "enum": [ "any", "all" ], "type": "string", "description": "Whether a store must use any one of the apps above, or all of them.", "default": "any" }, "exclude_apps": { "title": "Does not use these apps", "type": "array", "description": "Stores that use any of these apps are left out. Use it to find stores without your app category.", "items": { "type": "string" } }, "pixels": { "title": "Uses these pixels", "type": "array", "description": "Tracking pixels, such as Meta Pixel or TikTok Pixel. Stores that use any of them are returned.", "items": { "type": "string" } }, "traffic_tiers": { "title": "Monthly visits", "type": "array", "description": "Estimated monthly visit bands. Leave empty for every size.", "items": { "type": "string", "enum": [ "<50K", "50K-200K", "200K-1M", "1M-5M", "5M-20M", "20M+" ], "enumTitles": [ "Under 50K", "50K to 200K", "200K to 1M", "1M to 5M", "5M to 20M", "Over 20M" ] } }, "shopify_plus": { "title": "Only Shopify Plus stores", "type": "boolean", "description": "Return only stores with Shopify Plus signals.", "default": false }, "first_seen_within_days": { "title": "Only new stores (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Return only stores first seen in the last N days. Schedule the run weekly with 7 to get new stores only." }, "max_results": { "title": "Maximum stores", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many stores to return, up to 1,000 per run. Above 100, results come in full pages of 100, so 250 returns 200. You pay only for returned stores.", "default": 100 }, "domains": { "title": "Store URLs to analyze", "type": "array", "description": "Paste store URLs or domains, such as allbirds.com, to get one row per store. When this list has entries, the filters above are ignored. Stores not in the database are reported and not charged. Up to 1,000 per run.", "items": { "type": "string" } }, "filters": { "title": "Advanced filters (JSON)", "type": "object", "description": "Optional StoreInspect filter object, for example revenue tiers, theme type, store age or Meta ad count. A field set here replaces the matching control above. See the README for supported fields." } } }, "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 } } } } } } } } } }