API reference

Amazon Scraper API Docs.

The Amazon API creates parsing jobs, reports live progress and returns export files for ecommerce research and catalog workflows.

Get free sampleSee 100-row proof runView sample data
Output previewAmazon product record · 12 fields shown
ProductAvailabilityPrice
La Roche-Posay Cicaplast Balm B5 CreamB0060OUV5Y · 4.7 · 20,743 reviews
In stock$18.99
Maybelline Sky High MascaraB08H3JPH74 · 4.5 · 181,639 reviews
In stock$10.82
Aquaphor Healing OintmentB0107QPFBU · 4.8 · 138,730 reviews
In stock$12.79
Dove Sensitive Skin Body WashB00SK71SAG · 4.8 · 62,276 reviews
In stock$10.97
{
  "status": "succeeded",
  "marketplace": "amazon",
  "input_type": "product_url_list",
  "mode": "full_product",
  "delivered_records": 1,
  "charged_units": 5,
  "sample": {
    "product_id": "B0060OUV5Y",
    "title": "La Roche-Posay Cicaplast Balm B5 Cream",
    "brand": "La Roche-Posay",
    "price": 18.99,
    "currency": "USD",
    "ASIN": "available when Amazon renders this field",
    "rating": 4.7,
    "reviews_count": 20743,
    "stock": "In Stock",
    "images": [
      "https://m.media-amazon.com/images/I/713Ca5aXpyL._SL1500_.jpg"
    ],
    "category_path": [
      "Beauty & Personal Care",
      "Skin Care",
      "Face",
      "Creams"
    ],
    "product_url": "https://www.amazon.com/dp/B0060OUV5Y"
  },
  "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"
  }
}
curl -X POST https://parseshelf.com/api/v1/jobs \
  -H 'Authorization: Bearer $PARSESHELF_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"marketplace":"amazon","input_type":"product_url_list","input_value":"https://www.amazon.com/dp/B0060OUV5Y","mode":"full_product","target_count":20}'
Example output · only delivered rows spend unitsCSV · XLSX · JSONL · Markdown
Search intent

Terms this page answers.

Amazon scraper API docsAmazon product data API docsAmazon ASIN API docsAmazon search API docs
Guide

How to use this ParseShelf resource.

Create a job

Send a POST request to /api/v1/jobs with marketplace set to amazon. Choose input_type based on the source: search_url for Amazon search pages, category_url for category pages, product_url_list for direct product URLs, or asin_list for bulk ASIN enrichment.

Use listing_only when you need discovery rows and ranking positions. Use full_product when you need product page fields such as brand, bullets, images, product details, stock text, shipping information, variants and review signals.

Poll progress

The job status endpoint exposes status, delivered record counts, charged units, speed and export readiness. This lets a script wait for completion without guessing when Amazon data is ready.

The dashboard shows the same lifecycle for non-technical users. That makes ParseShelf easier to roll out because product researchers and developers do not need separate tools.

Download exports

Use the download endpoint when status is succeeded. JSONL is line-oriented for pipelines, CSV is portable for BI tools, XLSX is easiest for spreadsheet users and Markdown helps produce quick internal reports.

All export formats come from the same normalized rows, so a team can inspect a spreadsheet and ship a JSONL pipeline without reconciling two schemas.

Production checklist

Start with one small input and compare the delivered fields with the report, catalog or pipeline you actually need.

Keep the job ID, source URL, mode and run date with downstream exports so operators and developers can audit the same result.

Related pages

Continue the Amazon data workflow.

Open-source Chrome Extension Python Quickstart JavaScript Quickstart Amazon Scraper API Amazon Product Data API API Benchmark Guide Product Advertising API Alternative Sample Product Data
FAQ

Amazon Scraper API Docs questions.

What endpoint creates Amazon jobs?
POST /api/v1/jobs creates Amazon parsing jobs from URLs, keywords or ASIN lists.
Can I download CSV through the API?
Yes. Use the job download endpoint with format csv after the job succeeds.
What mode should I use first?
Use listing_only for discovery and full_product for product details and richer exports.