# Shopify Store Catalog & B2B Lead Enricher (`api-market/shopify-catalog-lead-enricher`) Actor

Extract Shopify product catalogs, variant pricing, stock availability, contact emails, socials, and installed e-commerce apps.

- **URL**: https://apify.com/api-market/shopify-catalog-lead-enricher.md
- **Developed by:** [Khan](https://apify.com/api-market) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 product or store profiles

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Shopify Store Catalog & B2B Lead Enricher

Extract clean **Shopify product catalogs** (variants, min/max pricing, compare-at prices, SKUs, stock availability) OR enriched **B2B store lead profiles** (public contact emails, social links, detected marketing/review/subscription tech stack, and catalog price distribution) from any Shopify storefront — **zero proxies and zero headless browsers**.

Built for e-commerce marketing agencies, B2B lead generation teams, dropshipping researchers, and competitive pricing analysts.

***

### Key Features & Why Use This Actor

- **Dual Extraction Modes (`products` & `store_profile`):** Switch between granular SKU-level product monitoring and 1-row-per-store B2B lead enrichment.
- **Tech Stack Detection (`detectedApps`):** Automatically detects 13 high-signal Shopify apps including **Klaviyo, Meta Pixel, TikTok Pixel, Google Tag Manager, Google Analytics 4, Judge.me, Yotpo, Loox, Recharge, Gorgias, Privy, Attentive, and Okendo**.
- **Clean Contact & Social Extraction:** Extracts public storefront emails (filtering out image filenames and tracking noise like Sentry/Wixpress) plus Instagram, TikTok, Facebook, X/Twitter, YouTube, and LinkedIn URLs.
- **Catalog Analytics Per Store:** Summarizes `sampleProductCount`, `currencyGuess`, `minPrice`, `medianPrice`, `maxPrice`, `outOfStockPct`, `topVendors`, and `topProductTypes`.
- **Proxy-Free Speed:** Fetches `/products.json` and storefront HTML directly inside a lightweight `node:22-alpine` container with automatic `429` retry handling.

***

### Popular Use Cases

- **Agency & SaaS Cold Outreach:** Scan lists of Shopify domains in `store_profile` mode to find DTC brands missing Klaviyo, Recharge, or Gorgias and enrich CRM records with contact emails + socials.
- **Competitor Price & Stock Monitoring:** Schedule `products` mode runs to detect price drops (`compareAtPrice` vs `minPrice`), new product launches, and out-of-stock SKUs.
- **E-Commerce Market Intelligence:** Benchmark catalog sizes, median product prices, and brand mix across a niche.

***

### Input Parameters

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `domains` | `string[]` | Yes | `["allbirds.com"]` | Shopify store domains or full URLs (e.g. `allbirds.com`, `https://gymshark.com`). |
| `mode` | `string` | No | `"products"` | `"products"` emits every product with pricing/SKUs/stock; `"store_profile"` emits one enriched B2B lead record per domain. |
| `maxPagesPerStore` | `integer` | No | `2` | Maximum `/products.json` pages fetched per domain (`1–40`; up to 250 products/page in `products` mode, 100/page in `store_profile` mode). |
| `maxItems` | `integer` | No | `200` | Global cap on output records emitted in this run (`1–20,000`). |

#### Example Input (`store_profile` B2B Lead Enrichment)

```json
{
  "domains": [
    "allbirds.com",
    "gymshark.com"
  ],
  "mode": "store_profile",
  "maxPagesPerStore": 1,
  "maxItems": 100
}
```

#### Example Input (`products` Catalog Monitoring)

```json
{
  "domains": [
    "allbirds.com"
  ],
  "mode": "products",
  "maxPagesPerStore": 2,
  "maxItems": 200
}
```

***

### Sample Output (Live Verified JSON)

#### `store_profile` Mode

```json
{
  "recordType": "store_profile",
  "domain": "allbirds.com",
  "storeTitle": "Allbirds: Comfortable, Sustainable Shoes & Apparel",
  "emails": [
    "help@allbirds.com"
  ],
  "socials": {
    "instagram": "https://www.instagram.com/allbirds",
    "tiktok": "https://www.tiktok.com/@weareallbirds",
    "facebook": "https://www.facebook.com/weareallbirds",
    "x": "https://twitter.com/allbirds",
    "youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw",
    "linkedin": ""
  },
  "detectedApps": [
    "Google Tag Manager",
    "Google Analytics 4",
    "Yotpo"
  ],
  "sampleProductCount": 100,
  "currencyGuess": "USD",
  "minPrice": 15,
  "medianPrice": 100,
  "maxPrice": 145,
  "outOfStockPct": 0,
  "topVendors": [
    {
      "name": "Allbirds",
      "count": 100
    }
  ],
  "topProductTypes": [
    {
      "name": "Shoes",
      "count": 62
    },
    {
      "name": "Gift Cards",
      "count": 1
    }
  ]
}
```

#### `products` Mode

```json
{
  "recordType": "product",
  "domain": "allbirds.com",
  "productId": "7119956050000",
  "title": "Digital Gift Card",
  "handle": "digital-gift-cards",
  "productUrl": "https://allbirds.com/products/digital-gift-cards",
  "vendor": "Allbirds",
  "productType": "Gift Cards",
  "tags": [
    "category:Gift Cards",
    "FINAL SALE"
  ],
  "minPrice": 15,
  "maxPrice": 500,
  "compareAtPrice": null,
  "available": true,
  "variantCount": 11,
  "skus": [
    "GIFTDGT015",
    "GIFTDGT500"
  ],
  "imageUrl": "https://cdn.shopify.com/s/files/1/1104/4168/files/Q424_Gifting_Site_PDP_GiftCard_1600x1600_3cbf0651-7406-4a93-910a-551a042bfe4f.png?v=1730312896",
  "publishedAt": "2026-11-18T16:00:39-08:00",
  "updatedAt": "2026-11-19T13:16:43-08:00"
}
```

***

### Pricing (Pay-Per-Event)

This Actor uses **Pay-Per-Event (PPE)** pricing:

- **Primary Event:** `result-item`
- **Suggested Rate:** **`$0.002` per item** (**`$2.00` per 1,000 products or enriched store profiles**)
- **Note:** In `store_profile` mode, each domain produces only **1 record** regardless of how many catalog pages are sampled for pricing stats.

***

### Integrations & Exports

- **Export Formats:** JSON, CSV, Excel (XLSX), JSONL.
- **CRM & Outreach Pipelines:** Connect via **n8n, Make, Zapier, or Apify API** to sync enriched Shopify leads straight into HubSpot, Clay, Airtable, or Google Sheets.
- **AI Agent Ready:** Compatible with **Apify MCP** for automated e-commerce research.

***

### FAQ

**How much does enriching 100 Shopify store profiles cost?**\
In `store_profile` mode, each store emits 1 `result-item` record, so 100 enriched stores is only 100 events (`~$0.20` at `$0.002`/item) plus negligible compute.

**What happens if a Shopify store disables `/products.json`?**\
In `store_profile` mode, the Actor still parses homepage HTML for `storeTitle`, `emails`, `socials`, and `detectedApps` and logs a warning for the catalog stage without crashing the rest of your domain batch.

**Does this work on custom-domain Shopify stores?**\
Yes. Pass the store's public custom domain (e.g., `allbirds.com`) — you do not need its `.myshopify.com` subdomain.

# Actor input Schema

## `domains` (type: `array`):

Domains or store URLs (e.g. allbirds.com, gymshark.com).

## `mode` (type: `string`):

'store_profile' outputs one enriched B2B lead record per domain; 'products' outputs every product & price/stock.

## `maxPagesPerStore` (type: `integer`):

Maximum /products.json catalog pages to fetch per store domain.

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

Global cap on total products or store profiles output in this run.

## Actor input object example

```json
{
  "domains": [
    "allbirds.com"
  ],
  "mode": "products",
  "maxPagesPerStore": 2,
  "maxItems": 200
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `items` (type: `string`):

No description

# 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 = {
    "domains": [
        "allbirds.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("api-market/shopify-catalog-lead-enricher").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 = { "domains": ["allbirds.com"] }

# Run the Actor and wait for it to finish
run = client.actor("api-market/shopify-catalog-lead-enricher").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 '{
  "domains": [
    "allbirds.com"
  ]
}' |
apify call api-market/shopify-catalog-lead-enricher --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,api-market/shopify-catalog-lead-enricher"
        }
    }
}
```

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/mtagd1DvoyB6vUpcf/builds/vhuZdsgvC1p2yl4VK/openapi.json
