🚀 WooCommerce Store API & Product Catalog Scraper

Enterprise-grade, ultra-lightweight web extraction micro-app designed for WooCommerce / WordPress Stores Worldwide. Extracts full product catalogs, variants, pricing, stock availability, SKUs, and imagery directly into clean structured data without headless browser overhead.

---

⚡ Why Use This Extractor?

• Zero Headless Browser Overhead: Bypasses heavy Chromium/Playwright instances by directly targeting structured endpoints and embedded data payloads. Runs in milliseconds with minimal RAM.
• Pay-Per-Event (PPE): Never pay for idle compute or proxy time. Only pay $1.50 / 1,000 items, with free starter runs available on your monthly Apify plan.
• AI Agent & MCP Native: Built from the ground up for function calling in Claude Desktop, Cursor, OpenAI Assistants, and LangChain via Apify MCP Server.
• Export Anywhere: Download dataset results instantly in JSON, CSV, Excel, or stream via webhooks.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
startUrls	Array	Yes	[{ "url": "https://wptavern.com" }]	One or more store URLs or category listing pages
maxItems	Integer	No	25	Maximum number of products to extract per run
useApifyProxy	Boolean	No	true	Route through datacenter/residential proxies for maximum uptime

Input JSON Example

{
  "startUrls": [
    { "url": "https://wptavern.com" }
  ],
  "maxItems": 25,
  "useApifyProxy": true
}

---

📤 Sample Output Data

Extracted records are formatted and validated against strict schemas before delivery:

{
  "url": "https://wptavern.com/product/wordpress-classic-hoodie",
  "title": "WordPress Classic Hoodie",
  "status": "VALID",
  "engine": "Engine-Ecommerce-JsonLD",
  "extractedAt": "2026-10-22T02:00:00Z",
  "data": {
    "id": 4521,
    "name": "WordPress Classic Hoodie",
    "prices": {
      "price": "4500",
      "regular_price": "5500",
      "currency_code": "USD"
    },
    "is_in_stock": true,
    "categories": [
      {
        "id": 12,
        "name": "Apparel"
      }
    ]
  }
}

---

🤖 AI Agent & MCP Integration (Claude / Cursor)

Use this Actor as an autonomous tool for AI agents via the official Apify MCP Server.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--token", "YOUR_APIFY_TOKEN"]
    }
  }
}

Prompt example for Claude / Cursor:

"Extract the product catalogue and current pricing from https://wptavern.com using the woocommerce-store-api-extractor actor."

---

🔌 Automate with n8n / Make.com

1. In n8n or Make, add an Apify node or HTTP Request.
2. Actor ID / Name: joseabreuy/woocommerce-store-api-extractor.
3. Pass your startUrls list.
4. Pipe output items directly to Airtable, Google Sheets, Supabase, or PostgreSQL.

---

💻 Programmatic Usage (cURL & Python)

cURL

curl --request POST \
  --url "https://api.apify.com/v2/acts/joseabreuy~woocommerce-store-api-extractor/runs?token=YOUR_APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "startUrls": [{ "url": "https://wptavern.com" }],
    "maxItems": 10
  }'

Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("joseabreuy/woocommerce-store-api-extractor").call(
    run_input={"startUrls": [{"url": "https://wptavern.com"}], "maxItems": 10}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"])

---

💰 Pricing & Free Trial

• Pay-Per-Event: Only $1.50 / 1,000 items
• Minimal Start Fee: $0.00005 per run
• Free Allowance: Use your default monthly $5.00 Apify credit to run thousands of extractions at zero out-of-pocket cost!