{ "openapi": "3.0.1", "info": { "title": "Shopify Store Finder: Filter by Apps, Theme, Country", "description": "Search a ranked database of popular Shopify stores. Filter by country, niche keywords, installed apps (Klaviyo, Judge.me, Recharge...), theme, traffic rank and catalog size. Pay only for stores returned.", "version": "0.2", "x-build-id": "XFX0aUzBZG4gGhxsO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/storesignal~shopify-store-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-storesignal-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/storesignal~shopify-store-finder/runs": { "post": { "operationId": "runs-sync-storesignal-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/storesignal~shopify-store-finder/run-sync": { "post": { "operationId": "run-sync-storesignal-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": { "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Number of stores to return.", "default": 100 }, "offset": { "title": "Offset", "minimum": 0, "type": "integer", "description": "Number of matching stores to skip, for paging through results.", "default": 0 }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter ISO country codes of the store, for example US, GB, DE. Empty means any country.", "items": { "type": "string" } }, "currencies": { "title": "Currencies", "type": "array", "description": "Store currency codes, for example USD, EUR. Empty means any currency.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Case-insensitive substrings matched against store name, description and domain. A store matches if it contains any of the keywords.", "items": { "type": "string" } }, "apps": { "title": "Uses all of these apps", "uniqueItems": true, "type": "array", "description": "The store must use every selected app. Example: Klaviyo. Stores without app data are skipped when any of the apps, excludeApps or themes filters is used.", "items": { "type": "string", "enum": [ "Accessibly", "Affirm", "Afterpay", "AfterSell", "AfterShip", "Air Reviews", "Algolia", "Amplitude", "Analyzify", "AppLovin", "Attentive", "Axeptio", "Back in Stock", "BiteSpeed", "Bold", "Bold Subscriptions", "Boost Commerce", "Candy Rack", "Cookiebot", "CookieYes", "Cowlendar", "Criteo", "Drift", "EComposer", "EcomSend", "Elevar", "Elevate A/B Testing", "Fast Bundle", "Fera", "FoxKit", "Fullstory", "GA4", "GemPages", "Globo Product Options", "Google & YouTube", "Google Ads Conversion", "Google Tag Manager", "Gorgias", "Growave", "Heap", "Hotjar", "Hubspot", "Hulk Form Builder", "Intercom", "Joy Loyalty", "Judge.me", "Justuno", "Kaching Bundles", "Kaching Cart", "Kimonix", "Klarna", "Klaviyo", "Klaviyo Reviews", "Langify", "LangShop", "Littledata", "Loop Returns", "Loox", "LoyaltyLion", "Lucky Orange", "Mailchimp", "Mercado Pago", "Meta Pixel", "Microsoft Clarity", "Mixpanel", "Northbeam", "Okendo", "Omnisend", "OneTrust", "Orbe", "Ordergroove", "PageFly", "Pandectes", "ParcelPanel", "Pinterest Tag", "Polar Analytics", "Pop Convert", "Postscript", "Privy", "PushOwl", "Rebuy", "Recharge", "ReConvert", "Reddit Pixel", "ReelUp", "Releasit COD Form", "Restock Rocket", "RevenueHunt", "REVIEWS.io", "Rivo", "Route", "Ryviu", "Scalapay", "Searchanise", "Segment", "Sezzle", "Shogun", "Shop Pay Installments", "Shopify Forms", "Shopify Inbox", "Simple Bundles", "Skio", "Smile.io", "Snap Pixel", "Stamped", "Stape", "Student Beans", "Swym", "Tidio", "TikTok Pixel", "TrackBee", "Transcy", "Triple Whale", "Trustoo", "Trustpilot", "UpCart", "Vitals", "Weglot", "Wishlist Plus", "Yotpo", "Yotpo Loyalty", "Zendesk", "Zipify" ] } }, "excludeApps": { "title": "Uses none of these apps", "uniqueItems": true, "type": "array", "description": "The store must use none of the selected apps. Example: Recharge, Skio. Stores without app data are skipped when any of the apps, excludeApps or themes filters is used.", "items": { "type": "string", "enum": [ "Accessibly", "Affirm", "Afterpay", "AfterSell", "AfterShip", "Air Reviews", "Algolia", "Amplitude", "Analyzify", "AppLovin", "Attentive", "Axeptio", "Back in Stock", "BiteSpeed", "Bold", "Bold Subscriptions", "Boost Commerce", "Candy Rack", "Cookiebot", "CookieYes", "Cowlendar", "Criteo", "Drift", "EComposer", "EcomSend", "Elevar", "Elevate A/B Testing", "Fast Bundle", "Fera", "FoxKit", "Fullstory", "GA4", "GemPages", "Globo Product Options", "Google & YouTube", "Google Ads Conversion", "Google Tag Manager", "Gorgias", "Growave", "Heap", "Hotjar", "Hubspot", "Hulk Form Builder", "Intercom", "Joy Loyalty", "Judge.me", "Justuno", "Kaching Bundles", "Kaching Cart", "Kimonix", "Klarna", "Klaviyo", "Klaviyo Reviews", "Langify", "LangShop", "Littledata", "Loop Returns", "Loox", "LoyaltyLion", "Lucky Orange", "Mailchimp", "Mercado Pago", "Meta Pixel", "Microsoft Clarity", "Mixpanel", "Northbeam", "Okendo", "Omnisend", "OneTrust", "Orbe", "Ordergroove", "PageFly", "Pandectes", "ParcelPanel", "Pinterest Tag", "Polar Analytics", "Pop Convert", "Postscript", "Privy", "PushOwl", "Rebuy", "Recharge", "ReConvert", "Reddit Pixel", "ReelUp", "Releasit COD Form", "Restock Rocket", "RevenueHunt", "REVIEWS.io", "Rivo", "Route", "Ryviu", "Scalapay", "Searchanise", "Segment", "Sezzle", "Shogun", "Shop Pay Installments", "Shopify Forms", "Shopify Inbox", "Simple Bundles", "Skio", "Smile.io", "Snap Pixel", "Stamped", "Stape", "Student Beans", "Swym", "Tidio", "TikTok Pixel", "TrackBee", "Transcy", "Triple Whale", "Trustoo", "Trustpilot", "UpCart", "Vitals", "Weglot", "Wishlist Plus", "Yotpo", "Yotpo Loyalty", "Zendesk", "Zipify" ] } }, "themes": { "title": "Theme (any of)", "type": "array", "description": "Base theme names, matched in full and ignoring case. Example: Dawn, Impulse. Stores without app data are skipped when any of the apps, excludeApps or themes filters is used.", "items": { "type": "string" } }, "tlds": { "title": "Domain extensions", "type": "array", "description": "Public suffixes such as com, co.uk, de. A leading dot is optional.", "items": { "type": "string" } }, "maxTrafficRank": { "title": "Max traffic rank", "enum": [ "1000", "5000", "10000", "50000", "100000", "500000", "1000000" ], "type": "string", "description": "Only stores in the Chrome UX Report popularity bucket up to this value. Stores not in the report are excluded." }, "maxMajesticRank": { "title": "Max Majestic rank", "minimum": 1, "type": "integer", "description": "Only stores with a Majestic Million rank at or below this value (1 is best)." }, "minProducts": { "title": "Min products", "minimum": 0, "type": "integer", "description": "Only stores with at least this many products. Stores with unknown product count are excluded." }, "maxProducts": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Only stores with at most this many products. Stores with unknown product count are excluded." } } }, "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 } } } } } } } } } }