# Shopify Product Details Scraper (`apt_marble/shopify-product-details-scraper`) Actor

Turn any Shopify product link into a full record: title, description, variants, prices, availability, images and identifiers...

- **URL**: https://apify.com/apt\_marble/shopify-product-details-scraper.md
- **Developed by:** [Hamza](https://apify.com/apt_marble) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.50 / 1,000 rich product records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Product Details Scraper

Paste one or more Shopify product links and get back a full structured record for each: title, description, variants, prices, availability, images and identifiers. Built for anyone who needs the complete picture of individual products: dropshippers enriching listings, price-tracking teams watching single SKUs, content teams reusing descriptions and imagery, and analysts auditing variant-level detail.

### What you can do with it

- **Turn a product link into a record** — paste `https://allbirds.com/products/...` links and get titles, prices, variants, stock flags and images back as clean rows.
- **Enrich a product feed** — SKUs, barcodes, weights and full image sets plug straight into listings and catalogs.
- **Watch key SKUs** — re-run the same links daily and diff prices, discounts and availability per variant.
- **Reuse product content** — plain-text and full-markup descriptions plus captioned images for content pipelines.
- **Audit variant detail** — option axes, quantity rules and fulfillment flags per variant in one place.

### What you get

One rich row per product. Abridged sample of a single record:

```json
{
  "storeDomain": "allbirds.com",
  "productId": "7292464955472",
  "handle": "mens-cruiser",
  "url": "https://allbirds.com/products/mens-cruiser",
  "title": "Men's Cruiser",
  "vendor": "Allbirds",
  "productType": "Shoes",
  "currency": "USD",
  "price": { "amount": 105, "currency": "USD" },
  "compareAtPrice": null,
  "variantsCount": 2,
  "availableCount": 1,
  "description": "Court style comfort.",
  "descriptionHtml": "<p>Court style comfort.</p>",
  "images": [{ "src": "https://cdn.shopify.com/a.webp", "alt": null, "width": 1521, "height": 2000, "position": 1, "variantIds": [] }],
  "variants": [
    { "variantId": "1", "title": "8", "sku": "A1", "barcode": null, "price": { "amount": 105, "currency": "USD" }, "compareAtPrice": null, "available": null, "option1": "8", "position": 1, "grams": 454, "inventoryManagement": "shopify", "taxable": true, "requiresShipping": true }
  ]
}
```

### Input reference

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| Product URLs | list of text | — | Shopify product page links, e.g. `https://allbirds.com/products/mens-cruiser`. One full record is collected per link. **Required.** |
| Max items | whole number | `200` | Maximum products to collect. The actor works through your links until this number is reached or the links run out. Maximum 2,000. |
| Currency | text | empty | Three-letter currency code for prices, e.g. `USD`. Leave empty to use each store's own currency. |

### Output fields

| Field | Type | Description |
| --- | --- | --- |
| `storeDomain` | text | Store the product was read from. |
| `productId` | text | Stable product ID. |
| `handle` | text | URL slug of the product page. |
| `url` | text | Clean link to the product page. |
| `title` | text | Product name. |
| `vendor` | text | Brand or supplier when shown. |
| `productType` | text | Store's own product grouping when shown. |
| `tags` | list of text | Merchandising tags when shown. |
| `status` | text | Publication status when shown. |
| `publishedAt` | text | When the product went live on the storefront. |
| `createdAt` | text | When the product record was created. |
| `updatedAt` | text | Last edit timestamp. |
| `currency` | text | Currency code all price pairs in the row use, confirmed by the store. |
| `price` | price pair | Lowest variant price as `{ amount, currency }`. |
| `compareAtPrice` | price pair | Strike-through price when on sale, otherwise empty. |
| `minPrice` | price pair | Lowest variant price. |
| `maxPrice` | price pair | Highest variant price. |
| `variantsCount` | number | How many variants the product has. |
| `availableCount` | number | How many variants are currently in stock. |
| `options` | list | Variant axes such as Size and Color with their values. |
| `description` | text | Plain-text product description when shown. |
| `descriptionHtml` | text | Full product description markup when shown. |
| `imageUrl` | text | Main product image. |
| `imageUrls` | list of text | Every product image. |
| `images` | list | Per-image rows: source, alt text, dimensions, position and linked variants. |
| `variants` | list | Full per-variant rows: ID, title, SKU, barcode, price pair, stock flag, options, weight, inventory and tax flags, quantity rules and image. |
| `templateSuffix` | text | Store's page template marker when set. |
| `publishedScope` | text | Publication scope when shown. |

### Pricing

You pay per rich product record, with no monthly minimum.

| What you are charged for | Price |
| --- | --- |
| Rich product record — one record added to your dataset | **$1.50 per 1,000** |

### Limits & what this actor cannot do

- Records are a snapshot at the moment of collection; prices, discounts and stock flags keep changing afterwards.
- Fields a store does not show come back empty rather than guessed — a product with no listed barcode has no barcode in its row.
- Stock is reported as a simple in/out flag per variant where the store publishes one; exact quantities are not published by stores.
- Non-product links (collection pages, home page, other sites) are skipped, not charged.
- Speed depends on the size of the job and on each store's own response times; no fixed throughput is promised.
- The source site's terms govern automated access. You are responsible for using the data lawfully and in line with the source site's terms, and for handling any personal data in line with applicable privacy law.

### FAQ

**Do I need a store account?**
No. The actor reads only what stores show publicly on product pages.

**Does it need my login or password?**
No. There is nothing to connect and nothing to configure — paste product links and press start.

**What counts as a product link?**
A link containing `/products/`, such as `https://allbirds.com/products/mens-cruiser`. Anything else is skipped.

**How many products can I collect per run?**
Up to 2,000 links in one run.

**Can I schedule it?**
Yes. Schedule it hourly, daily or weekly from the Apify console, and each run writes a fresh dataset you can compare against the last.

**Is the data complete?**
It is complete for everything the store shows openly on the product page. Where a store omits a field, the actor leaves it empty rather than guessing.

# Actor input Schema

## `productUrls` (type: `array`):

Shopify product page links, e.g. "https://allbirds.com/products/mens-cruiser". One full record is collected per link.

## `maxItems` (type: `integer`):

Maximum products to collect. The actor works through your links until this number is reached or the links run out.

## `currency` (type: `string`):

Three-letter currency code for prices, e.g. "USD". Leave empty to use each store's own currency.

## Actor input object example

```json
{
  "productUrls": [
    "https://www.allbirds.com/products/mens-cruiser-medium-grey"
  ],
  "maxItems": 200,
  "currency": ""
}
```

# Actor output Schema

## `results` (type: `string`):

Every row this run produced.

## `runSummary` (type: `string`):

What this run collected, and anything it could not read.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "productUrls": [
        "https://www.allbirds.com/products/mens-cruiser-medium-grey"
    ],
    "maxItems": 200,
    "currency": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("apt_marble/shopify-product-details-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "productUrls": ["https://www.allbirds.com/products/mens-cruiser-medium-grey"],
    "maxItems": 200,
    "currency": "",
}

# Run the Actor and wait for it to finish
run = client.actor("apt_marble/shopify-product-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "productUrls": [
    "https://www.allbirds.com/products/mens-cruiser-medium-grey"
  ],
  "maxItems": 200,
  "currency": ""
}' |
apify call apt_marble/shopify-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apt_marble/shopify-product-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZSbWBOtsGanObKd9N/builds/wCI8CYI4upBbZkXGF/openapi.json