# Shopify Store Scraper (`novashieldai/shopify-store-scraper`) Actor Scrape any Shopify store for products, collections, prices, variants, inventory, and store info. Works with all 4M+ Shopify stores via public JSON endpoints. - **URL**: https://apify.com/novashieldai/shopify-store-scraper.md - **Developed by:** [Ali haydar Karadaş](https://apify.com/novashieldai) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Shopify Store Scraper Extract product listings, detailed product data, collections, and store information from any Shopify-powered online store. We built this to be the go-to tool for e-commerce intelligence -- pull pricing, inventory, variants, and store metadata from any Shopify store in seconds. ### What does Shopify Store Scraper do? This actor provides six modes for thorough Shopify store analysis. **Products mode** lists all products from a store with title, handle, URL, vendor, product type, price, compare-at price, currency, featured image, tags, availability, and dates. Supports pagination and sorting by best selling, title, price, or creation date. **Product mode** takes a product handle (URL slug) and returns the full product page data. That includes the HTML description, plain text description, all product options (Size, Color, etc.), every variant with its own price, compare-at price, SKU, barcode, weight, availability, inventory quantity, and shipping/tax settings. You also get all product images with dimensions and alt text, variant count, total inventory, and price range. **Search mode** searches within a store's product catalog using keywords. Same output as products mode but filtered by your query. **Collections mode** lists all collections in the store with title, handle, URL, description, image, product count, and dates. **Collection products mode** returns all products within a specific collection. **Store info mode** extracts store-level metadata: store name, description, URL, currency, country, city, province, ZIP, phone, email, money format, product and collection counts, Shopify theme name, detected plan, password protection status, social media links, and detected Shopify apps. ### What data do you get? - Product ID, title, handle, and full URL - Vendor/brand and product type/category - Starting price and compare-at price with currency - Featured image URL and all product images with dimensions - Product tags, availability status, and created/updated/published dates - HTML and plain text descriptions - Product options (Size, Color, Material, etc.) - All variants: price, compare-at price, SKU, barcode, weight, availability, inventory quantity, shipping and tax settings - Variant count, total inventory, and price range - Collections: title, handle, URL, description, image, product count - Store info: name, description, currency, country, location, contact details, theme, plan, social links, detected apps ### Who is this for? - **E-commerce competitors** tracking rival product catalogs, pricing strategies, and new arrivals - **Dropshippers** sourcing products and monitoring supplier inventory and pricing changes - **Market researchers** analyzing product assortments and pricing patterns across Shopify stores - **Brand protection teams** monitoring unauthorized resellers and MAP violations - **Developers** building integrations or tools that need Shopify store data ### How to use it 1. Pick your mode: products, product, search, collections, collection_products, or store_info. 2. Enter the store domain (e.g., "allbirds.com" or "store.myshopify.com"). 3. For product mode, add the product handle. For search, add your query. For collection_products, add the collection handle. 4. Set result limits, page, and sort order as needed. 5. Run it and export your data. ### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | mode | string | products | Mode: products, product, search, collections, collection_products, store_info | | domain | string | - | Shopify store domain (e.g., "allbirds.com") | | handle | string | - | Product URL slug (for product mode) | | query | string | - | Search keywords (for search mode) | | collection | string | - | Collection slug (for collection_products mode) | | sort | string | - | Sort: best_selling, title_asc, title_desc, price_asc, price_desc, created_asc, created_desc | | limit | integer | 30 | Maximum results (1-250) | | page | integer | 1 | Page number (1-50) | ### Sample output ```json { "id": 7234567890123, "title": "Tree Runner - Everyday Sneaker", "handle": "tree-runner", "url": "https://www.allbirds.com/products/tree-runner", "vendor": "Allbirds", "product_type": "Shoes", "price": 98.00, "compare_at_price": null, "currency": "USD", "image": "https://cdn.shopify.com/s/files/1/tree-runner-main.jpg", "tags": ["mens", "running", "sustainable", "tree-fiber"], "available": true, "created_at": "2025-03-15T10:00:00Z", "updated_at": "2026-06-09T08:30:00Z", "published_at": "2025-03-15T10:00:00Z" } ```` ### How much does it cost? This actor costs **$0.004 per result**. 1,000 products cost $4 and 10,000 cost $40. Every Apify account comes with $5 in free monthly credits -- plenty to scrape several stores and evaluate the data quality. ### Common questions **Does it work with any Shopify store?** It works with any publicly accessible Shopify store that is not password-protected. The actor automatically detects whether a domain runs on Shopify. **Can I get inventory levels?** Some stores expose inventory quantities through their API. When available, each variant includes the inventory\_quantity field. Not all stores make this data public. **How do I find the product handle or collection handle?** The handle is the URL slug. For example, if the product URL is "allbirds.com/products/tree-runner", the handle is "tree-runner". Same for collections -- "allbirds.com/collections/mens" means the handle is "mens". ### Contact & Custom Solutions Need a custom scraper, higher volume, or a specific integration? We're here to help. If anything isn't working right or you need support, don't hesitate to reach out. - Telegram: [t.me/novashield\_dev](https://t.me/novashield_dev) - Email: novashield.dev@gmail.com # Actor input Schema ## `mode` (type: `string`): Mode ## `domain` (type: `string`): Shopify store domain (e.g., allbirds.com or store.myshopify.com) ## `handle` (type: `string`): Product URL slug for 'product' mode ## `query` (type: `string`): Search keywords for 'search' mode ## `collection` (type: `string`): Collection slug for 'collection\_products' mode ## `sort` (type: `string`): Sort ## `limit` (type: `integer`): Max Results ## `page` (type: `integer`): Page ## Actor input object example ```json { "mode": "products", "domain": "allbirds.com", "limit": 30, "page": 1 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "domain": "allbirds.com" }; // Run the Actor and wait for it to finish const run = await client.actor("novashieldai/shopify-store-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "domain": "allbirds.com" } # Run the Actor and wait for it to finish run = client.actor("novashieldai/shopify-store-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "domain": "allbirds.com" }' | apify call novashieldai/shopify-store-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=novashieldai/shopify-store-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Store Scraper", "description": "Scrape any Shopify store for products, collections, prices, variants, inventory, and store info. Works with all 4M+ Shopify stores via public JSON endpoints.", "version": "1.0", "x-build-id": "xoLeQQiJmsVTPD4xR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/novashieldai~shopify-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-novashieldai-shopify-store-scraper", "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/novashieldai~shopify-store-scraper/runs": { "post": { "operationId": "runs-sync-novashieldai-shopify-store-scraper", "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/novashieldai~shopify-store-scraper/run-sync": { "post": { "operationId": "run-sync-novashieldai-shopify-store-scraper", "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": "Mode", "enum": [ "products", "product", "search", "collections", "collection_products", "store_info" ], "type": "string", "description": "Mode", "default": "products" }, "domain": { "title": "Store Domain", "type": "string", "description": "Shopify store domain (e.g., allbirds.com or store.myshopify.com)" }, "handle": { "title": "Product Handle", "type": "string", "description": "Product URL slug for 'product' mode" }, "query": { "title": "Search Query", "type": "string", "description": "Search keywords for 'search' mode" }, "collection": { "title": "Collection Handle", "type": "string", "description": "Collection slug for 'collection_products' mode" }, "sort": { "title": "Sort", "enum": [ "best_selling", "title_asc", "title_desc", "price_asc", "price_desc", "created_asc", "created_desc" ], "type": "string", "description": "Sort" }, "limit": { "title": "Max Results", "minimum": 1, "maximum": 250, "type": "integer", "description": "Max Results", "default": 30 }, "page": { "title": "Page", "minimum": 1, "maximum": 50, "type": "integer", "description": "Page", "default": 1 } } }, "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 } } } } } } } } } } ```