Postman guide

Amazon Scraper API Postman Collection.

Test ParseShelf Amazon API requests in Postman before wiring them into a production script or internal tool.

Preview 5 rows free See 100-row proof run View sample data

Output previewCanonical ProductRow · 10 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

{
  "schema_version": "1.0",
  "status": "succeeded",
  "outcome": "full",
  "has_failures": false,
  "marketplace": "amazon",
  "input_type": "product_url_list",
  "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",
    "product_url": "https://www.amazon.com/dp/B0060OUV5Y",
    "rating": 4.7,
    "reviews_count": 20743
  },
  "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"
  }
}

# Amazon product sample

| ASIN | Product | Price (USD) |
| --- | --- | --- |
| B0060OUV5Y | La Roche-Posay Cicaplast Balm B5 Cream | 18.99 |

Illustrative row. Run a live preview for current data.

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}'

See the workflow

Real screens from the product.

Open a screenshot to inspect the actual path from input to output and observed intelligence.

Current ParseShelf preview interface showing input → live rows — **Input → live rows**A visitor can test one URL or up to 20 ASINs before signing in.

Current ParseShelf output interface showing rows → exports — **Rows → exports**Inspect the columns before choosing your export.

Current ParseShelf research interface showing market intelligence — **Market Intelligence**Compare observed prices and spot changes over time.

Guide

How to use this ParseShelf resource.

Why test in Postman

Postman is useful when a developer, analyst or technical founder wants to validate the request body, authentication header and export flow before writing code. It also makes it easy to share a working request inside a team.

Use an environment variable for PARSESHELF_KEY and keep the request body focused on one input type at a time.

Request body

The most important fields are marketplace, input_type, input_value, mode and target_count. The examples use product_url_list for one product, but the same endpoint also accepts search_url, category_url and asin_list.

If a request works in Postman but fails in production, compare headers, JSON escaping and environment variables first.

After creation

Copy the returned job ID into the status and download requests. Poll until the job reaches succeeded, then download JSONL, CSV, XLSX or Markdown.

This mirrors the production integration and helps a team understand the whole lifecycle, not just the create request.

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.

Postman requestReference

{
  "name": "Create Amazon product data job",
  "request": {
    "method": "POST",
    "url": "https://parseshelf.com/api/v1/jobs",
    "header": [
      {"key": "Authorization", "value": "Bearer {{PARSESHELF_KEY}}"},
      {"key": "Content-Type", "value": "application/json"}
    ],
    "body": {
      "mode": "raw",
      "raw": "{\"marketplace\":\"amazon\",\"input_type\":\"product_url_list\",\"input_value\":\"https://www.amazon.com/dp/B0060OUV5Y\",\"mode\":\"full_product\",\"target_count\":1}"
    }
  }
}

OpenAPI JSON Python quickstart GitHub Python repo JavaScript quickstart

Pick one Amazon input source: search URL, category URL, product URL list or ASIN list.
Use listing_only for broad discovery and full_product for richer product-page fields.
Keep canonical asin, source_url, product_url, stock_status and stock_text in downstream datasets; map legacy product_id at ingestion.
Download JSONL for pipelines, CSV for imports, XLSX for operators and Markdown for reports.
Record job IDs so dashboard rows and API exports can be reconciled later.
Link related docs, samples and comparison pages when evaluating an Amazon data workflow.

Continue the Amazon data workflow.

FAQ

Amazon Scraper API Postman Collection questions.

Can I import this as a full collection?

The page includes the request shape and the generated OpenAPI file can be used to build a fuller collection.

Where does the API key go?

Put it in the Authorization header as Bearer PARSESHELF_KEY.

Can Postman download exports?

Yes. Add a GET request to the download endpoint after the job succeeds.