WatShop WooScrap
βš™οΈ API

WooScrap API Reference

WatShop WooScrap API reference: detect a store, scrape products, and export to WooCommerce CSV, Shopify CSV, raw CSV or JSON. Authentication, rate limits and plan limits.

The WatShop WooScrap API powers the dashboard and is available to authenticated accounts. Requests are JSON over HTTPS; authentication uses your logged-in session cookie. Endpoints are rate-limited and bounded by your plan’s per-scrape and per-day limits.

Authentication

Sign in via the web app to obtain a session cookie, then call the API from the same origin. Scrape and export endpoints require an active subscription; the public detect endpoint can be called without one.

Detect a store

POST /api/public/detect β€” body { "url": "https://store.example" }. Returns whether the URL is a reachable WooCommerce store and an estimate of how many products are visible.

Scrape products

POST /api/scraper/scrape β€” body { "url": "https://store.example", "limit": 100 }. Returns the captured products. The effective limit is the smaller of your request and your plan’s max products per scrape; each call counts against your daily quota.

Export

  • POST /api/scraper/export/csv β€” WooCommerce importer CSV
  • POST /api/scraper/export/shopify β€” Shopify product CSV
  • POST /api/scraper/export/raw β€” raw CSV of every captured field

Each export takes the products array returned by a scrape and streams back a downloadable file.

Rate limits & quotas

API requests are rate-limited per minute. Daily scrape counts reset at midnight UTC, and the per-scrape product cap is set by your plan. Admin accounts are exempt from the daily cap.