---
title: "Get library detail"
method: GET
path: "/api/libraries/{slug}"
tags: ["Libraries"]
---

# Get library detail

`GET /api/libraries/{slug}`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/libraries/{slug}`
- Auth: HTTP bearer

Returns one library + the datasets the calling user can see. Public datasets are always returned; workspace-scoped datasets are returned only to members.

## Path parameters

- `slug` string, required

## Response `200`

Library + visible datasets

- LibraryDetail
  - `curator` string, nullable
  - `dataset_count` integer, required
  - `description` string, nullable
  - `episode_count` integer, required
  - `is_subscribed` boolean, required: Whether the calling user is a member of this library.
  - `name` string, required
  - `slug` string, required: Stable URL slug, e.g. `audioscrape`.
  - `subscriber_count` integer, required
  - `datasets` DatasetSummary[], required
    - `description` string, nullable
    - `episode_count` integer, required
    - `id` integer, required
    - `name` string, required
    - `podcast_count` integer, required
    - `slug` string, required
    - `visibility` string, required: `public`, `workspace`, or `private`.

## Other responses

- `401`: Missing or invalid API key
- `402`: No active subscription (paid endpoint requires a subscription)
- `403`: Endpoint not available on the caller's plan
- `404`: Library not found (or private and caller not a member)
- `429`: Monthly quota exhausted (response includes `usage: { current, limit }`)

---

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