Shopify Public Catalog & Variant Change API

Read public Shopify catalogs and variant prices with product hashes for change detection. No login or invented sales estimates.

What you can do

Track publicly exposed product and variant prices across repeated catalog snapshots.

Quick start

{
  "storeUrl": "https://www.allbirds.com/",
  "maxItems": 10,
  "maxPages": 1
}

Run the Actor and download the default dataset as JSON, CSV or Excel. Inspect the OUTPUT key-value-store record before treating the run as complete. Live example sources can change or become unavailable.

Behavior and limitations

Uses a store's public /products.json endpoint, up to 100 products per page. Products include variants, price, compare_at_price, availability flags, tags and image URLs as exposed by the source. No authentication, bypass, proxies or browser is used. Prices are source strings; currency is not inferred. Public variant available values do not provide stock counts. Pass previousHashes keyed by productId to detect changed product snapshots. No removals are inferred. complete is true only after an empty pagination page, with no errors or truncation; reaching maxItems or maxPages is explicitly partial. Robots restrictions, HTTP blocking or absent endpoints are reported as errors. Compatibility depends on the individual storefront, not just Shopify branding.

Every result preserves its source URL and an observedAt UTC timestamp. Network or parsing errors are listed by source in OUTPUT.errors; other successful sources still return results. OUTPUT.warnings, complete and status distinguish a full observation from partial output. If every requested source fails, the run fails rather than silently returning an empty success.

Pricing

USD 1 per 1,000 successful product snapshot rows ($0.001 per row), plus a $0.005 Actor-start event for the default 256 MB run. No result event is charged for a failed source. The Actor-start event can still apply to a failed run. Higher memory can increase start-event quantity according to Apify's rules. This description must match the currently effective Store pricing; check the pricing tab before running. Apify charges only as configured there.

Resource and access limits

At most 1,000 output rows; public ports 80/443 only; five redirects; 2 MiB decoded body per request; approximately 100 seconds for fetching. Requests are sequential with no retries, CAPTCHA bypass, credentials, residential proxies or paid upstream APIs. robots.txt is respected; missing robots.txt (404/410) allows fetching, while blocked or unavailable policies produce errors. Public DNS addresses are validated and pinned for each connection. Use only sources you are permitted to access and respect source terms. Private networks and URLs with embedded credentials are rejected.

API and automation

Call POST https://api.apify.com/v2/actors/soilair~shopify-public-catalog-change-api/runs with the example JSON and your own Apify authorization header. Poll the returned run ID, then fetch /v2/datasets/{defaultDatasetId}/items. Schedule subsequent runs in Apify Console; pass earlier keys/hashes explicitly where supported. The Actor never schedules jobs itself.

Data handling and support

Input and results remain in your Apify run's storage under the platform's retention settings. The Actor sends requests only to the input sources, their public redirects and robots.txt. No separate analytics or customer-data endpoint is used. Do not put secrets or private customer URLs in the input. Developed with AI assistance and tested with deterministic fixtures plus public-source smoke checks; this does not guarantee all storefronts or websites will work. For support, send the run ID, source URL and expected behavior via the Apify issue tab without credentials.