This example shows the exact shape a developer can use to create a ParseShelf Amazon job. Operators can run the same workflow in the web dashboard, inspect live rows, and download files without writing code.
Use search_url when the seed is a search url. Use full_product when you need product page fields such as brand, bullets, stock text, shipping information, variants, media and review signals. Use listing_only for fast discovery scans before enriching selected ASINs.
Every completed job exposes the same normalized contract across API responses, JSONL exports, CSV files, Excel workbooks and Markdown reports, so downstream systems do not need a separate parser for each Amazon page type.
curl requestPOST /api/v1/jobscurl -X POST https://parseshelf.com/api/v1/jobs \
-H "Authorization: Bearer $PARSESHELF_KEY" \
-H "Content-Type: application/json" \
-d '{"marketplace": "amazon", "input_type": "search_url", "input_value": "https://www.amazon.com/s?k=vitamin+c+serum&i=beauty", "mode": "full_product", "target_count": 20}'
{
"schema_version": "1.0",
"status": "succeeded",
"outcome": "full",
"has_failures": false,
"marketplace": "amazon",
"input_type": "search_url",
"mode": "full_product",
"delivered_records": 1,
"records_delivered": 1,
"records_failed": 0,
"charged_units": 5,
"sample": {
"asin": "B0060OUV5Y",
"title": "La Roche-Posay Cicaplast Balm B5 Cream",
"brand": "La Roche-Posay",
"price": 18.99,
"currency": "USD",
"stock_status": "in_stock",
"stock_text": "In Stock",
"position": 1,
"rating": 4.7,
"reviews_count": 20743,
"images": [
"https://m.media-amazon.com/images/I/713Ca5aXpyL._SL1500_.jpg"
],
"product_url": "https://www.amazon.com/dp/B0060OUV5Y",
"source_query": "vitamin c serum"
},
"exports": {
"jsonl": "/api/v1/jobs/{job_id}/download/jsonl",
"csv": "/api/v1/jobs/{job_id}/download/csv",
"xlsx": "/api/v1/jobs/{job_id}/download/xlsx",
"md": "/api/v1/jobs/{job_id}/download/md"
}
}
