audiometa.io

audiometa.io Web API

Catalog REST API for artists, albums, and tracks — including enrichment such as social stats, playcounts, and audio features. Authentication Create API keys…

Media & content#music

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Catalog REST API for artists, albums, and tracks — including enrichment such as social stats, playcounts, and audio features.

Authentication

Create API keys in the Audiometa dashboard.

Authorization: Bearer amsk_…

Also accepted: x-api-key: amsk_…

  • Up to 3 keys per account
  • The raw secret is returned only at creation or rotation time

Rate limiting

Each API key is limited to 100 requests per minute. Limits are enforced per key (not per account). Exceeding the limit returns HTTP 429.

  • Window: 60 seconds · Max: 100 requests per key
  • Applies to all authenticated /v1 endpoints (docs and OpenAPI are not counted)
  • When limited, the response uses status 429 with the standard error JSON shape

Errors

All errors use the same JSON shape:

{ "error": { "status": 401, "message": "Invalid API key." } }

Common statuses: 400 bad params, 401 auth, 404 not found, 429 rate limited, 500 server error.

Pagination

List endpoints return offset/limit paging:

{
  "href": "…",
  "items": [],
  "limit": 20,
  "next": "…",
  "offset": 0,
  "previous": null,
  "total": 0
}

Object conventions

Shared fields: id, type, href, uri (audiometa:artist:amart_…), external_urls, images, name, popularity.

Audiometa extensions:

  • Artist — stats, bio, genres, country_code
  • Track — playcounts, audio_features
  • Album — label, upc, album_type, release_date, release_date_precision

Browse tracks with /tracks/by-key, /tracks/by-tempo, /tracks/by-label (sort + order supported).

Merged audiometa.io IDs resolve to the canonical entity. Unknown IDs return 404.

Base URL

Production: https://api.audiometa.io/v1

Interactive docs: https://api.audiometa.io/v1/docs · OpenAPI: https://api.audiometa.io/v1/openapi.json

Endpoints 15

Search

  • GETSearch the catalog/v1/search?q=drakeSearch artists, albums, and/or tracks by free-text query. Returns a paging object per requested type.

Artists

  • GETGet several artists/v1/artists?ids=amart_01h…,amart_01i…Fetch multiple artists by audiometa.io ID. Pass up to 50 comma-separated IDs. Unknown IDs are omitted from the response.
  • GETGet an artist/v1/artists/:idFull artist object including genres, bio, follower totals, and social/platform stats.
  • GETGet an artist's albums/v1/artists/:id/albumsAll albums credited to an artist, paginated. Optionally filter with include_groups (e.g. album,single,ep,compilation).
  • GETGet an artist's tracks/v1/artists/:id/tracksAll tracks credited to an artist, paginated and ordered by popularity. Each item may include album and Spotify playcount.
  • GETGet an artist's top tracks/v1/artists/:id/top-tracksMost popular tracks for an artist (up to 10), ordered by popularity.
  • GETGet related artists/v1/artists/:id/related-artistsArtists related to the given artist in the Audiometa catalog.

Albums

  • GETGet several albums/v1/albums?ids=amalb_01h…,amalb_01i…Fetch multiple albums by audiometa.io ID. Pass up to 20 comma-separated IDs. Unknown IDs are omitted from the response.
  • GETGet an album/v1/albums/:idAlbum details including label, UPC, popularity, and an embedded first page of tracks.
  • GETGet an album's tracks/v1/albums/:id/tracksPaginated tracklist for an album (default limit 50, max 50).

Tracks

  • GETGet several tracks/v1/tracks?ids=amtrk_01h…,amtrk_01i…Fetch multiple tracks by audiometa.io ID. Pass up to 50 comma-separated IDs. Unknown IDs are omitted from the response.
  • GETGet tracks by musical key/v1/tracks/by-key?key=0Browse tracks matching a Spotify pitch-class key (0–11). Optionally filter by mode (0 minor, 1 major). Supports sort (popularity, tempo, name, key) and order…
  • GETGet tracks by BPM range/v1/tracks/by-tempo?tempo_min=120&tempo_max=128Browse tracks whose tempo falls between tempo_min and tempo_max (inclusive). Supports sort (popularity, tempo, name, key) and order (asc, desc).
  • GETGet tracks by record label/v1/tracks/by-label?label=OVOBrowse tracks on albums whose label name contains label (case-insensitive). Supports sort (popularity, tempo, name, key) and order (asc, desc).
  • GETGet a track/v1/tracks/:idFull track object including album, credits, playcounts, and audio features when available.

API details

Base URL
https://api.audiometa.io
Authentication
A bearer token in the Authorization header
An API key in the x-api-key header
Operations
15 operations on 15 pathsGET 15
Main resources
Artists 6Tracks 5Albums 3Search 1
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the audiometa.io Web API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the audiometa.io Web API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Search the catalog” (GET /v1/search?q=drake), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the audiometa.io Web API?

Catalog REST API for artists, albums, and tracks — including enrichment such as social stats, playcounts, and audio features. Authentication Create API keys… It is listed under Media & content and has 15 endpoints.

Who publishes the audiometa.io Web API?

It is listed from audiometa.io's public API description (an OpenAPI document), not published by audiometa.io on Swastik Codes. Anyone who controls audiometa.io can claim the profile by adding a DNS TXT record.

What is the base URL of the audiometa.io Web API?

Requests go to https://api.audiometa.io. Endpoint paths are added to this base URL.

How do I authenticate with the audiometa.io Web API?

It accepts 2 methods: A bearer token in the Authorization header; an API key in the x-api-key header.

How many endpoints does the audiometa.io Web API have?

15 operations on 15 paths (15 GET). The largest groups are Artists, Tracks, Albums, Search.

Is forking the audiometa.io Web API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.