Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Search Album API
version: 1.0.0
servers:
- url: https://host.com
description: Default
tags:
- name: Album
paths:
/https://business.artlist.io/search/v1/album/{id}:
get:
operationId: album-controller-get-album
summary: Album Controller Get Album
tags:
- Album
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Get album by id
content:
application/json:
schema:
$ref: '#/components/schemas/GetAlbumResponse'
components:
schemas:
AlbumCollaborativeArtistDetails:
type: object
properties:
id:
type: string
name:
type: string
required:
- id
- name
title: AlbumCollaborativeArtistDetails
Album:
type: object
properties:
id:
type: string
name:
type: string
description:
type: string
slug:
type: string
artist:
$ref: '#/components/schemas/AlbumArtistDetails'
coverImage:
type: string
insetImage:
type: string
featuredArtists:
type: array
items:
$ref: '#/components/schemas/AlbumCollaborativeArtistDetails'
description: List of featured artists in the album
primaryArtists:
type: array
items:
$ref: '#/components/schemas/AlbumCollaborativeArtistDetails'
description: List of primary artists in the album
required:
- id
- name
- description
- slug
- artist
- coverImage
- insetImage
- featuredArtists
- primaryArtists
title: Album
AlbumArtistDetails:
type: object
properties:
id:
type: string
name:
type: string
slug:
type: string
description: Slug of the artist for URL
required:
- id
- name
- slug
title: AlbumArtistDetails
GetAlbumResponse:
type: object
properties:
album:
$ref: '#/components/schemas/Album'
required:
- album
title: GetAlbumResponse
x-provenance:
method: harvested
publisher: Artlist
source: https://developer.artlist.io/openapi/search.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)