# Amazon New Releases Scraper (`apt_marble/amazon-new-releases-scraper`) Actor

See what just launched on Amazon. Scrape New Releases, Most Wished For and Most Gifted charts into a ranked dataset with price, rating and review count for every product, up to 100 per chart. Any category or subcategory, any marketplace, with optional full product details.

- **URL**: https://apify.com/apt\_marble/amazon-new-releases-scraper.md
- **Developed by:** [Hamza](https://apify.com/apt_marble) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 chart entry scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Amazon New Releases Scraper

See what just launched on Amazon, before it becomes a best seller. This actor
turns Amazon's discovery charts — **New Releases**, **Most Wished For** and
**Most Gifted** — into a clean ranked dataset for any category or subcategory.
Pick a category, or paste the address of any chart, and get every ranked product
back with its position, price, rating and review count. Built for sellers
hunting trends early, brands watching new competitors arrive, and buyers
planning seasonal ranges.

### What you can do with it

- **Catch trends early.** New Releases is where a category's next best seller
  shows up first, weeks before it climbs the main chart.
- **Spot new competitors the week they launch.** Schedule a run and diff it
  against yesterday's to see exactly what is new in your category.
- **Plan gifting ranges.** Most Wished For and Most Gifted show what shoppers
  save and buy for other people, which is a very different list from what sells
  day to day.
- **Validate a product idea.** If nothing like yours has launched in months, the
  chart tells you. If five things launched last week, it tells you that too.
- **Track a subcategory, not just a department.** Paste the address of any
  subcategory chart and get its own ranking.
- **Feed a product research tool.** Every row carries the ASIN and a clean
  product address, so it joins onto whatever you already have.

### What you get

One row per ranked position. A row looks like this:

```json
{
  "rank": 1,
  "asin": "B0DJGDC3BD",
  "title": "Amazon Fire TV Stick HD (newest model), free & live TV, Alexa Voice Remote",
  "url": "https://www.amazon.com/dp/B0DJGDC3BD",
  "image": "https://images-na.ssl-images-amazon.com/images/I/41vNuqAqL._AC_UL300_.jpg",
  "price": 19.99,
  "currency": "USD",
  "priceType": "buybox",
  "offerCount": null,
  "rating": 4.1,
  "ratingsCount": 3276,
  "detailLevel": "full",
  "chartType": "new-releases",
  "chartName": "New Releases",
  "category": "electronics",
  "categoryNodeId": null,
  "chartTitle": "New Releases in Electronics",
  "updateFrequency": "frequently",
  "chartPage": 1,
  "marketplace": "us",
  "scrapedAt": "2026-08-07T12:00:00.000Z"
}
```

Amazon ranks more positions than it publicly describes. Those extra positions
are still returned, with their true rank and a `detailLevel` that says so:

```json
{
  "rank": 31,
  "asin": "B0H4Z6DTPN",
  "title": null,
  "url": "https://www.amazon.com/dp/B0H4Z6DTPN",
  "price": null,
  "rating": null,
  "detailLevel": "rank-only"
}
```

Switch on **Include full product details** and those rows are filled in from the
product's own listing, along with specifications, images, the full star
breakdown, the buy-box seller and category rankings.

### Input reference

| Input | Type | Default | What it does |
| --- | --- | --- | --- |
| **Chart categories** | list | `electronics` | Which categories to read. Pick one or more from the list. |
| **Or paste chart links** | list of text | empty | Any Amazon New Releases, Most Wished For or Most Gifted address, for subcategories that are not in the list. A pasted address keeps its own chart type. |
| **Chart type** | choice | `New Releases` | Which of Amazon's discovery charts to read: New Releases, Most Wished For or Most Gifted. |
| **Maximum products per chart** | number | `50` | Stop after this many ranked products in each chart. Up to 100. |
| **Include full product details** | true / false | `false` | Open each entry and collect the complete product record. Much slower, and billed separately. |
| **Amazon marketplace** | choice | `United States` | Which country's Amazon site to read. Prices come back in that marketplace's own currency. |
| **Parallel targets** | number | `4` | How many charts to work on at the same time, up to 10. Higher is faster, but Amazon serves fewer complete results when pushed hard. |

### Output fields

| Field | Type | Description |
| --- | --- | --- |
| `rank` | number | The position Amazon gives the product in the chart, 1–100. |
| `asin` | text | Amazon's product identifier. |
| `title` | text | Full product title. |
| `url` | text | Clean product address, free of tracking. |
| `image` | text | Product image. |
| `price` | number | Price shown on the chart, in the marketplace's own currency. |
| `currency` | text | The currency the price is actually in. |
| `priceType` | text | `buybox` when it is the main price, `lowest_offer` when Amazon shows the cheapest offer from other sellers. |
| `offerCount` | number | How many other offers exist, when Amazon shows that. |
| `rating` | number | Star rating out of 5. |
| `ratingsCount` | number | How many customers rated the product. |
| `detailLevel` | text | `full`, `rank-only`, or `enriched` when full product details were collected. |
| `chartType` | text | `new-releases`, `most-wished-for` or `most-gifted`. |
| `chartName` | text | Human-readable chart name. |
| `category` | text | The category the chart belongs to. |
| `categoryNodeId` | text | Subcategory identifier, when the chart is a subcategory. |
| `chartTitle` | text | The chart's own heading, as Amazon writes it. |
| `chartUrl` | text | Address of the chart the row came from. |
| `updateFrequency` | text | How often Amazon says the chart refreshes. |
| `chartPage` | number | Which half of the chart the row came from. |
| `marketplace` | text | The marketplace the run used. |
| `scrapedAt` | text | Collection timestamp, in UTC. |

With **Include full product details** switched on, each row also carries
`brand`, `parentAsin`, `listPrice`, `savingsPercent`, `availability`,
`inStock`, `buyBoxSeller`, `shipsFrom`, `isAmazonSold`, `starHistogram`,
`bestSellersRank`, `images`, `featureBullets`, `description`,
`specifications`, `breadcrumbs`, `variantCount`, `hasCoupon`, `couponText`,
`isPrime`, `dateFirstAvailable`, `dimensions` and `weight` — plus `chartPrice`,
so you can compare the chart's price with the product's own.

### Pricing

You pay per result, with no monthly minimum.

| What you pay for | Price |
| --- | --- |
| Each ranked product returned | **$0.60 per 1,000** |
| Each product enriched with full details | **$1.20 per 1,000** extra |

**Worked example.** Five categories, the full 100 ranked positions each, is 500
products: **$0.30**. Switch on full product details for the same run and it is
500 × ($0.0006 + $0.0012) = **$0.90**.

Full product details are optional and off by default, so a fast list-only run
stays at the lower price.

### Limits & what this actor cannot do

- Amazon publishes at most 100 ranked positions per chart, so a category comes
  back as its top 100 rather than as an unlimited catalogue.
- Amazon describes only part of what it ranks. Positions it lists without
  describing come back with `detailLevel: "rank-only"` — rank and ASIN, nothing
  else — unless you switch on full product details, which fills them in.
- **Most Wished For and Most Gifted overlap heavily.** On a measured category
  they shared most of their products and had the same number one. Treat them as
  two views of the same gifting demand rather than two independent lists.
- New Releases refreshes frequently; Most Wished For and Most Gifted refresh
  daily. Scheduling a daily chart more often than that just returns the same
  data, and every row carries `updateFrequency` so you can see which is which.
- Amazon does not publish how a product's rank changed since yesterday, so no
  rank-movement or trend figure is reported. Schedule the actor and compare two
  runs if you want movement.
- Amazon does not publish a launch date on these charts. "New" means Amazon
  placed the product in its New Releases ranking, not a date you can filter on.
  Full product details add `dateFirstAvailable` where Amazon states it.
- Some categories have no chart in some marketplaces. Those come back as empty,
  which is a real answer, and are reported separately from anything that failed.
- Movers & Shakers charts are not covered: Amazon returns them empty for most
  categories.
- Prices, ranks, ratings and stock are a snapshot at the moment of collection and
  keep changing afterwards.
- Prices and availability differ between Amazon marketplaces; results reflect
  the marketplace you select.
- With full product details on, the seller reported is the one currently winning
  the buy box. A full list of every competing seller for a product is not
  publicly listed and is not returned.
- With full product details on, Amazon shows only a selection of customer
  reviews publicly; the actor returns the full star breakdown rather than every
  review ever written.
- Customer questions and answers are not publicly listed and are not returned.
- Speed depends on the size of the job and on Amazon's own response times. No
  fixed throughput is promised.
- Amazon's terms govern automated access. You are responsible for using the data
  lawfully, in line with the source site's terms, and for handling any personal
  data in line with applicable privacy law.

### FAQ

**Do I need an Amazon account?**
No. The actor reads only what Amazon shows the public.

**Does it need my login or password?**
No. There is nothing to connect and nothing to sign in to — pick your chart and
press start.

**Can I schedule it?**
Yes. Run New Releases daily to catch launches early; Most Wished For and Most
Gifted only refresh once a day, so daily is enough for those too.

**What is the difference between the three charts?**
New Releases ranks recently launched products. Most Wished For ranks what
shoppers add to wish lists. Most Gifted ranks what shoppers buy as gifts. The
last two are closely related and often share most of their entries.

**Why do some rows have a rank but no title or price?**
Because Amazon ranks 100 products per chart but publicly describes only part of
them. Those rows are still returned with their true rank so your dataset is
complete, and switching on full product details fills them in.

**Is the data complete?**
It is complete for what Amazon publishes: up to 100 ranked positions per chart,
with every position accounted for. It is not a complete list of everything
launched in a category, because Amazon does not rank one.

**Can I track a subcategory?**
Yes. Open the subcategory chart on Amazon and paste its address into
**Or paste chart links**.

# Actor input Schema

## `categories` (type: `array`):

Which New Releases charts to read.

## `chartUrls` (type: `array`):

Any Amazon New Releases page links, for subcategories not in the list above.

## `chartType` (type: `string`):

Which of Amazon's discovery charts to read.

## `maxProductsPerChart` (type: `integer`):

Stop after this many ranked products in each chart.

## `includeProductDetails` (type: `boolean`):

Open each chart entry to collect the complete product record — full specifications, every image, the full rating breakdown and category rankings. Much slower and billed separately; leave off for a fast list.

## `marketplace` (type: `string`):

Which country's Amazon site to read. Prices, availability and rankings differ between marketplaces, and results come back in that marketplace's own currency.

## `maxConcurrency` (type: `integer`):

How many targets to work on at the same time. Higher is faster but Amazon serves fewer complete pages when pushed hard. Leave at 4 unless you have a reason.

## Actor input object example

```json
{
  "categories": [
    "electronics"
  ],
  "chartType": "new-releases",
  "maxProductsPerChart": 50,
  "includeProductDetails": false,
  "marketplace": "us",
  "maxConcurrency": 4
}
```

# Actor output Schema

## `results` (type: `string`):

Every row this run produced.

## `runSummary` (type: `string`):

What this run collected, and anything it could not read.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "categories": [
        "electronics"
    ],
    "chartType": "new-releases",
    "maxProductsPerChart": 50,
    "includeProductDetails": false,
    "marketplace": "us",
    "maxConcurrency": 4
};

// Run the Actor and wait for it to finish
const run = await client.actor("apt_marble/amazon-new-releases-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "categories": ["electronics"],
    "chartType": "new-releases",
    "maxProductsPerChart": 50,
    "includeProductDetails": False,
    "marketplace": "us",
    "maxConcurrency": 4,
}

# Run the Actor and wait for it to finish
run = client.actor("apt_marble/amazon-new-releases-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "categories": [
    "electronics"
  ],
  "chartType": "new-releases",
  "maxProductsPerChart": 50,
  "includeProductDetails": false,
  "marketplace": "us",
  "maxConcurrency": 4
}' |
apify call apt_marble/amazon-new-releases-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apt_marble/amazon-new-releases-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/eB6Quu52pRRZYulP7/builds/OaBMePimZbcuAJll5/openapi.json