Getting Started
Make your first product extraction in under 5 minutes. No SDK required.
What is ProductParse?
ProductParse is an API that turns any e-commerce product URL into clean, structured JSON. It uses a tiered extraction pipeline — starting with embedded JSON-LD (free and instant), falling back to domain-specific cached selectors, and finally using visual AI extraction when all else fails.
You get a consistent response schema no matter what site you're parsing.
Prerequisites
- An API key — create a free account for 100 requests/day
- A HTTP client (
curl, Python, JavaScript, or any language)
Your first request
Replace YOUR_API_KEY with the key from your dashboard.
curl -X POST https://api.productparse.dev/v1/parse \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.apple.com/shop/buy-iphone/iphone-15-pro"}'
Response
{
"title": "Apple iPhone 15 Pro",
"brand": "Apple",
"price": {
"amount": 1999.00,
"currency": "NZD"
},
"availability": "in_stock",
"images": [
"https://store.storeimages.cdn-apple.com/..."
],
"source": {
"type": "jsonld",
"method": "fast-path",
"confidence": 0.98
}
}
The source.method field tells you how the data was extracted. fast-path means JSON-LD was found in the page — no AI calls, instant response.
Extraction methods
ProductParse automatically picks the best method for each URL:
| Method | Speed | Cost | When used |
|---|---|---|---|
fast-path | ~100ms | Free | Page has embedded JSON-LD |
cached-script | ~500ms | Free | Domain was previously extracted |
adaptive | ~2–4s | API credit | No structure found, generates selectors |
visual | ~3–8s | API credit | Screenshot + vision model extraction |
Next steps
- Read Authentication to understand API key management
- Explore Parameters to customise extraction with hints and screenshots
- See Response Schema for the full field reference