# Bandcamp API: List releases by genre

> Lists Bandcamp releases in a genre, sorted by best-selling or new arrivals and filtered by format. Physical-format prices come from the matching package when available.

Unofficial. Not affiliated with or endorsed by Bandcamp.

- Page: https://fous.com/methods/bandcamp.com/list-releases-by-genre
- Method: `bandcamp.com/list_releases_by_genre`, version 1
- Website: bandcamp.com
- Returns: album title, artist, genre, release date, price, currency, cover image, album URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no |  | Listing order, for example new_arrivals. One of "best_selling", "new_arrivals". Default "best_selling". |
| `genre` | string | yes | `"electronic"` | Genre to browse, such as electronic, hip-hop, jazz, or metal. |
| `format` | string | no |  | Release format, for example vinyl. One of "all", "digital", "vinyl", "cd", "cassette". Default "all". |
| `max_results` | integer | no |  | Maximum albums to return, for example 30. Default 30. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "genre": "electronic"
}
```

Its output:

```json
{
  "releases": [
    {
      "genre": "electronic",
      "price": 4,
      "artist": "Amynedd",
      "currency": "GBP",
      "album_url": "https://amynedd.bandcamp.com/album/16-bit-adventure?from=discover_page",
      "album_title": "16-Bit Adventure",
      "release_date": "2020-10-21",
      "cover_image_url": "https://f4.bcbits.com/img/a1621207929_16.jpg"
    },
    {
      "genre": "electronic",
      "price": 1,
      "artist": "State Azure",
      "currency": "GBP",
      "album_url": "https://stateazure.bandcamp.com/album/ancient-light-longform-edit?from=discover_page",
      "album_title": "Ancient Light (Longform Edit)",
      "release_date": "2026-10-21",
      "cover_image_url": "https://f4.bcbits.com/img/a3001556591_16.jpg"
    },
    {
      "genre": "electronic",
      "price": 3.95,
      "artist": "the shallow margins (the humble bee & fields we found)",
      "currency": "GBP",
      "album_url": "https://quietdetails.bandcamp.com/album/tule?from=discover_page",
      "album_title": "tule",
      "release_date": "2026-10-21",
      "cover_image_url": "https://f4.bcbits.com/img/a3804072161_16.jpg"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"bandcamp.com/list_releases_by_genre","input":{"genre":"electronic"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the top-selling vinyl albums in jazz on Bandcamp right now
- What are the newest cassette releases in ambient music?
- List 15 best-selling digital electronic albums sorted by popularity
- Find recent hip-hop CD releases, newest first, up to 50 results
- I want metal albums on bandcamp.com with prices in cassette format, newest arrivals first

## Input schema

```json
{
  "type": "object",
  "required": [
    "genre"
  ],
  "properties": {
    "sort": {
      "enum": [
        "best_selling",
        "new_arrivals"
      ],
      "type": "string",
      "default": "best_selling",
      "description": "Listing order, for example new_arrivals."
    },
    "genre": {
      "type": "string",
      "minLength": 1,
      "description": "Genre to browse, such as electronic, hip-hop, jazz, or metal."
    },
    "format": {
      "enum": [
        "all",
        "digital",
        "vinyl",
        "cd",
        "cassette"
      ],
      "type": "string",
      "default": "all",
      "description": "Release format, for example vinyl."
    },
    "max_results": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum albums to return, for example 30."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "releases"
  ],
  "properties": {
    "releases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "album_title",
          "artist",
          "genre",
          "release_date",
          "price",
          "currency",
          "cover_image_url",
          "album_url"
        ],
        "properties": {
          "genre": {
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "artist": {
            "type": "string"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "album_url": {
            "type": "string"
          },
          "album_title": {
            "type": "string"
          },
          "release_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "cover_image_url": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "description": "Releases in Bandcamp listing order."
    }
  }
}
```

## See more

- [Bandcamp API: Get album](https://fous.com/methods/bandcamp.com/get-album.md): Gets a Bandcamp album by title and optional artist, or by album link, with prices, physical formats, tracks and album details. Supporter count covers only profiles shown on the page; copies left is given only when displayed.
- [Pitchfork API: List latest album reviews](https://fous.com/methods/pitchfork.com/list-latest-reviews.md): Lists the newest Pitchfork album reviews. You can filter them by genre or limit them to Best New Music.
- [Genius API: List an artist's songs](https://fous.com/methods/genius.com/list-artist-songs.md): Lists an artist's songs on Genius by popularity or newest release date, with featured artists, release dates, page views and song art. The artist can be given by name or by Genius artist link; dates or views may be unavailable.
- [Shazam API: List top charts](https://fous.com/methods/shazam.com/list-top-charts.md): Gets Shazam's current ranked top songs for the world, a country, or a city, optionally by genre. City charts have up to 50 songs; genres are available only in some places.
- [SoundCloud API: List artist tracks](https://fous.com/methods/soundcloud.com/list-artist-tracks.md): Lists a SoundCloud artist's public tracks in latest or SoundCloud popular order, with profile and track details. SoundCloud's popular list may contain fewer than 100 tracks (currently at most 30).
- [Audible API: List best sellers](https://fous.com/methods/audible.com/list-best-sellers.md): Lists the current bestselling audiobooks of an Audible store (United States, United Kingdom, Canada, Australia, India, Germany, France, Italy, Spain, Brazil or Japan), overall or in one chart category, in chart order with listed prices.
- [Discogs API: Get release](https://fous.com/methods/discogs.com/get-release.md): Finds a Discogs release by title, artist or release link and returns its edition details, tracks, community counts, current price and sold price statistics.
- [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
- [All Bandcamp methods](https://fous.com/methods/bandcamp.com.md)