Amazon Album Charts

​

Amazon album charts. Handler runs QUERY_GET_AMAZON_ALBUM_CHARTS, joins per-album metadata via Album.getInfo("amazon", …) (rows without matching album info are dropped), and attaches historical rankStats from QUERY_GET_ALBUM_RANKINGS.AMAZON.

Query Parameters
  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • genre
    Type: string
    required

    Amazon genre filter. Use /api/charts/genres/amazon to retrieve the available genre IDs/names.

  • code2
    Type: string
    min length:  
    2
    max length:  
    2

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • type
    Type: string enum
    required

    Amazon album chart type (popular_album or new_album).

    values
    • popular_album
    • new_album
  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

  • limit
    Type: integer

    Maximum entries returned. Defaults to 500.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

Responses
  • application/json
Request Example for get/api/charts/amazon/albums
curl 'https://api.chartmetric.com/api/charts/amazon/albums?genre=&type=popular_album' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": null,
    "data": [
      {
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-07-20T17:45:03.313Z",
        "added_at": "2026-07-20T17:45:03.313Z",
        "velocity": null,
        "time_on_chart": "string",
        "amazon_album": "string",
        "original_id": null,
        "code2": null,
        "genre": null,
        "id": 0,
        "name": null,
        "upc": null,
        "label": null,
        "image_url": null,
        "release_date": "2026-07-20T17:45:03.313Z",
        "cm_album": null,
        "num_track": "string",
        "amazon_album_ids": [
          null
        ],
        "artists": [
          {}
        ],
        "rankStats": [
          {
            "rank": null,
            "timestp": "2026-07-20T17:45:03.313Z"
          }
        ]
      }
    ]
  }
}

Success