Public price and stock data
Read-only data from the same published feeds used by the calculator. No account is required.
- GET /discovery/v1/products
- GET /discovery/v1/prices?product=iphone-duo
- GET /discovery/v1/stock?product=iphone-duo&country=de&storage=256GB
- OpenAPI 3.1
- llms.txt
Filters
product, country (lowercase), storage (256GB, 512GB, 1TB, 2TB), colour (exact catalogue value), store (store identifier). Omit colour/store for all. Product IDs and supported capacities: products.json.
Reading the data
available is a recorded pickup reading, with pickup_day where known. online_delivery and delivery_later describe online-only markets, not pickup. unknown includes missing, failed, ineligible and expired observations. tracked:false means no matching catalogue parts, not zero inventory. The response reports any coverage warning.
checked_at_scope:store_variant identifies an exact per-store variant timestamp. Older snapshots can report market_variant; that is the latest country-level check of that part, not a precise per-store observation. Never describe unknown readings as out of stock.
Only checked_at timestamps describe observations. generated_at is response creation time, not a new stock check; snapshot_generated_at identifies the input snapshot. Data refreshes after scraper sweeps. Responses are cached for up to 60 seconds; underlying feeds are read at most every 10 seconds. Use the supplied source page URL as the citation. No request triggers an Apple scrape. Query limits are product/country scoped; invalid inputs return 400. A missing catalog returns 503.
Sources and freshness
Apple list prices are shown in the local currency and converted to USD. US and Canadian sales tax is extra. Tax refunds, import charges and travel are excluded; use the calculator for your home country.
Store readings expire according to their checking schedule. Missing, failed, ineligible or expired checks are unknown, never evidence that an item is out of stock. A snapshot older than two hours is also treated as unknown.
Dates and times are UTC. “Checked” is the oldest check among the configurations in that row; configuration details include their own timestamps.
Availability changes quickly. Confirm the exact configuration and pickup date with Apple before travelling.