JavaScript guide

Amazon Scraper API JavaScript Quickstart.

Use fetch in Node.js to create Amazon jobs, poll status and read structured JSONL rows from ParseShelf.

Get free sample See 100-row proof run View 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}'

Search intent

Terms this page answers.

Amazon scraper API JavaScriptAmazon product data API Node.jsAmazon ASIN API JavaScriptNode Amazon scraping API

Guide

How to use this ParseShelf resource.

When to use JavaScript

JavaScript is a practical fit for internal tools, serverless functions, dashboards and product research apps that already run on Node.js. The API job model keeps browser automation out of your application code.

The quickstart uses native fetch and a simple polling loop so the integration is portable across Node.js runtimes and deployment platforms.

Handling JSONL

JSONL exports are ideal for JavaScript services because each line is a complete JSON object. A worker can stream lines into a queue, database, enrichment pipeline or dashboard without loading the entire export into memory.

For small jobs, splitting the response text is enough. For larger jobs, stream the response body and parse line by line.

Operator handoff

Because ParseShelf also has a dashboard, developers can give product teams a visual place to inspect the exact jobs that the JavaScript service creates. That makes debugging product research workflows faster.

Keep job IDs in your own logs so an operator can open the same job in ParseShelf when a report needs investigation.

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.

JavaScriptReference

const baseUrl = "https://parseshelf.com";
const headers = {
  Authorization: `Bearer ${process.env.PARSESHELF_KEY}`,
  "Content-Type": "application/json"
};

const created = await fetch(`${baseUrl}/api/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    marketplace: "amazon",
    input_type: "asin_list",
    input_value: "B0060OUV5Y\nB08H3JPH74",
    mode: "full_product",
    target_count: 2
  })
}).then((response) => response.json());

let job = created;
while (!["succeeded", "failed", "cancelled"].includes(job.status)) {
  await new Promise((resolve) => setTimeout(resolve, 10000));
  job = await fetch(`${baseUrl}/api/v1/jobs/${created.id}`, { headers }).then((response) => response.json());
}

const rows = await fetch(`${baseUrl}/api/v1/jobs/${created.id}/download/jsonl`, { headers }).then((response) => response.text());
console.log(rows.split("\n").filter(Boolean).map((line) => JSON.parse(line)));

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 product_id, source_url and product_url in downstream datasets for auditability.
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 JavaScript Quickstart questions.

Can I use this from a browser?

Use the API from a trusted backend so the API key is not exposed to visitors.

Does the API return JSONL?

Yes. Download the jsonl export after the job succeeds.

Can I call it from serverless functions?

Yes. Create the job in one invocation and poll or process the export from a scheduled worker.