---
title: "Get an Audible curated editorial list"
method: GET
path: "/audible/list/{list}"
tags: ["Audible"]
---

# Get an Audible curated editorial list

`GET /audible/list/{list}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/audible/list/{list}`
- Auth: API key in header `x-api-key`

Returns one of Audible's hand-curated "Popular Lists" pages, as its themed shelves (heading + ordered ASINs). Pair an ASIN from any shelf with GET /audible/products (batch) or GET /audible/product/{asin} for full title/author/price/rating detail. "Best of the Year" is not covered.

## Path parameters

- `list` 'audiobooks' | 'booktok' | 'podcasts', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AudibleEditorialListResponseDoc
  - `code` integer
  - `data` AudibleEditorialListResponse
    - `list` string
    - `shelves` AudibleEditorialShelf[]
      - `asins` string[]
      - `heading` string
    - `source_url` string
    - `title` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)