> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New Releases

> Newly released products for a category (browse node).

## Query Parameters

<ParamField query="domain" type="string" default="com">
  Amazon marketplace TLD or code.

  Examples: `com`, `co.uk`, `de`
</ParamField>

<ParamField query="category" type="string">
  New-releases node id or category slug. Use [`/v1/amazon/categories`](/api-reference/endpoint/amazon/list-categories) to look up nodes.

  Example: `electronics`, `books`
</ParamField>

<ParamField query="page" type="integer" default={1}>
  Page number. Each page covers 50 ranks. Range: `1` - `2`.
</ParamField>

## Response

<ResponseField name="domain" type="string">Marketplace domain.</ResponseField>
<ResponseField name="category" type="string">Category/node the list was pulled from (nullable).</ResponseField>

<ResponseField name="results" type="array">
  Array of newly released products.

  <Expandable title="NewRelease object">
    <ResponseField name="rank" type="integer">New-release rank.</ResponseField>
    <ResponseField name="position" type="integer">Position on the page.</ResponseField>
    <ResponseField name="asin" type="string">Product ASIN.</ResponseField>
    <ResponseField name="title" type="string">Product title.</ResponseField>
    <ResponseField name="link" type="string">Full URL to the product page.</ResponseField>
    <ResponseField name="image" type="string">Primary product image URL.</ResponseField>
    <ResponseField name="rating" type="number">Average star rating (nullable).</ResponseField>
    <ResponseField name="ratings_total" type="integer">Total number of ratings (nullable).</ResponseField>
    <ResponseField name="price" type="object">Price object with `value`, `currency`, `symbol`, `raw`.</ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "domain": "com",
  "category": "electronics",
  "results": [
    {
      "rank": 1,
      "position": 1,
      "asin": "B0CX23V2ZK",
      "title": "Anker Prime Power Bank (2026)",
      "link": "https://www.amazon.com/dp/B0CX23V2ZK",
      "image": "https://m.media-amazon.com/images/I/61new.jpg",
      "rating": 4.6,
      "ratings_total": 842,
      "price": { "value": 129.99, "currency": "USD", "symbol": "$", "raw": "$129.99" }
    }
  ]
}
```

<Note>
  Each new-releases request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/amazon/new-releases
openapi: 3.1.0
info:
  title: ScrapeBadger Amazon API
  version: 1.0.0
  description: >-
    Amazon marketplace scraping API for searching products, fetching product
    details, offers, reviews, listings, sellers, and reference data across 20
    marketplaces.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/amazon/new-releases:
    get:
      tags:
        - Amazon Listings
      summary: New Releases
      description: Newly released products for a category (browse node).
      operationId: getAmazonNewReleases
      parameters:
        - name: domain
          in: query
          schema:
            type: string
            default: com
          description: Amazon marketplace TLD or code (com, co.uk, de, ...).
        - name: category
          in: query
          schema:
            type: string
          description: New-releases node id or category slug.
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
            maximum: 2
          description: Page number (each page covers 50 ranks; max 2).
      responses:
        '200':
          description: New releases list
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  category:
                    type: string
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Bestseller'
              example:
                domain: com
                category: electronics
                results:
                  - rank: 1
                    position: 1
                    asin: B0CX23V2ZK
                    title: Anker Prime Power Bank (2026)
                    link: https://www.amazon.com/dp/B0CX23V2ZK
                    image: https://m.media-amazon.com/images/I/61new.jpg
                    rating: 4.6
                    ratings_total: 842
                    price:
                      value: 129.99
                      currency: USD
                      symbol: $
                      raw: $129.99
components:
  schemas:
    Bestseller:
      type: object
      properties:
        rank:
          type: integer
          description: Best-seller / new-release rank.
        position:
          type: integer
          description: Position on the page.
        asin:
          type: string
        title:
          type: string
        link:
          type: string
        image:
          type: string
        rating:
          type: number
          nullable: true
        ratings_total:
          type: integer
          nullable: true
        price:
          $ref: '#/components/schemas/AmazonPrice'
    AmazonPrice:
      type: object
      properties:
        value:
          type: number
          nullable: true
          description: Numeric price value.
        currency:
          type: string
          nullable: true
          description: ISO 4217 currency code.
        symbol:
          type: string
          nullable: true
          description: Currency symbol (e.g. $, £, €).
        raw:
          type: string
          nullable: true
          description: Price exactly as displayed on Amazon.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````