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…
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
/v1endpoints (docs and OpenAPI are not counted) - When limited, the response uses status
429with 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 - Links
- OpenAPI document · Support
- Listed from
- Audiometa's published OpenAPI description
How to test the audiometa.io Web API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the audiometa.io Web API collection, without the publisher's secrets.
- 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.
- 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.