{ "openapi": "3.1.0", "info": { "title": "GrooveGauge openbare muziek-API", "version": "1.1.0", "description": "Muziekgegevens van GrooveGauge voor bevestigde accounts. Maak een API-sleutel op /nl/account/api/ en stuur die mee in de Authorization: Bearer-header. Alle gegevensroutes en de JSON-index vereisen een sleutel; documentatie, OpenAPI en OPTIONS blijven openbaar. Standaard gelden 60 verzoeken per UTC-minuut, 10 per UTC-venster van vijf seconden en 5.000 per UTC-dag, gedeeld door alle sleutels en beide taalversies. Je kunt maximaal vijf actieve sleutels hebben. Sleutelcontrole gebeurt vóór cache- en ETag-afhandeling. Reviewfragmenten bevatten maximaal 400 tekens en 60% van korte teksten; teksten korter dan 40 tekens krijgen geen fragment. Volledige reviews, biografieën, onderzoek en contactgegevens blijven buiten de API. Engels en Nederlands delen ID’s, eigennamen en scores; Nederlandse routes geven alleen gepubliceerde vertalingen terug. Behoud bronlinks en zet sleutels nooit in URL’s of openbare clientcode." }, "servers": [ { "url": "https://groovegauge.com/nl/api/v1", "description": "Nederlandse reviewfragmenten en paginalinks." }, { "url": "https://groovegauge.com/en/api/v1", "description": "Engelse reviewfragmenten en paginalinks." } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/reviews": { "get": { "summary": "Openbare recensies tonen", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "description": "" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 120 }, "description": "Artiestennaam, of artiestennaam of releasetitel bij recensies en releases. De zoekterm moet letterlijk voorkomen; hoofdletters maken geen verschil. De volledige reviewtekst wordt niet doorzocht." }, { "name": "spotify_id", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[A-Za-z0-9]{22}$" }, "description": "Alleen gecontroleerde artiest- en release-ID’s leveren resultaten op. Onbevestigde koppelingen blijven buiten de resultaten." }, { "name": "spotify_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "artist", "album", "track" ] }, "description": "Optionele specificatie van het soort Spotify-ID. Vereist spotify_id." }, { "name": "genre_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" }, { "name": "artist_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "album", "single" ] }, "description": "Soort recensie of release. Recensies accepteren alleen album of single." }, { "name": "release_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" } ], "responses": { "200": { "description": "Openbare records met paginering.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Review" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/reviews/{id}": { "get": { "summary": "Eén openbare recensie ophalen", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Eén beknopt openbaar record, met dezelfde inhoudslimieten als het overzicht.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Review" }, "attribution": { "$ref": "#/components/schemas/Attribution" } } } } } }, "404": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/artists": { "get": { "summary": "Openbare artiesten tonen", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "description": "" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 120 }, "description": "Artiestennaam, of artiestennaam of releasetitel bij recensies en releases. De zoekterm moet letterlijk voorkomen; hoofdletters maken geen verschil. De volledige reviewtekst wordt niet doorzocht." }, { "name": "spotify_id", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[A-Za-z0-9]{22}$" }, "description": "Alleen gecontroleerde artiest- en release-ID’s leveren resultaten op. Onbevestigde koppelingen blijven buiten de resultaten." }, { "name": "spotify_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "artist" ] }, "description": "Optionele specificatie van het soort Spotify-ID. Vereist spotify_id." }, { "name": "genre_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" } ], "responses": { "200": { "description": "Openbare records met paginering.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Artist" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/artists/{id}": { "get": { "summary": "Eén openbare artiest ophalen", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Eén beknopt openbaar record, met dezelfde inhoudslimieten als het overzicht.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Artist" }, "attribution": { "$ref": "#/components/schemas/Attribution" } } } } } }, "404": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/releases": { "get": { "summary": "Openbare releases tonen", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "description": "" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 120 }, "description": "Artiestennaam, of artiestennaam of releasetitel bij recensies en releases. De zoekterm moet letterlijk voorkomen; hoofdletters maken geen verschil. De volledige reviewtekst wordt niet doorzocht." }, { "name": "spotify_id", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[A-Za-z0-9]{22}$" }, "description": "Alleen gecontroleerde artiest- en release-ID’s leveren resultaten op. Onbevestigde koppelingen blijven buiten de resultaten." }, { "name": "spotify_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "artist", "album", "track" ] }, "description": "Optionele specificatie van het soort Spotify-ID. Vereist spotify_id." }, { "name": "genre_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" }, { "name": "artist_id", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "album", "single", "ep", "live", "compilation" ] }, "description": "Soort recensie of release. Recensies accepteren alleen album of single." } ], "responses": { "200": { "description": "Openbare records met paginering.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Release" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/releases/{id}": { "get": { "summary": "Eén openbare release ophalen", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Eén beknopt openbaar record, met dezelfde inhoudslimieten als het overzicht.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Release" }, "attribution": { "$ref": "#/components/schemas/Attribution" } } } } } }, "404": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/genres": { "get": { "summary": "Openbare genres tonen", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "description": "" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "description": "" } ], "responses": { "200": { "description": "Openbare records met paginering.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Genre" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/genres/{id}": { "get": { "summary": "Eén openbaar genre ophalen", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Eén beknopt openbaar record, met dezelfde inhoudslimieten als het overzicht.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Genre" }, "attribution": { "$ref": "#/components/schemas/Attribution" } } } } } }, "404": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/search": { "get": { "summary": "Openbare artiesten, releases en recensies doorzoeken", "description": "Geef q en/of spotify_id op. Elk van de drie resultaatgroepen heeft eigen paginering, met dezelfde waarden voor page en per_page. per_page is standaard 10 en maximaal 20. Volledige reviewteksten worden niet doorzocht of teruggegeven.", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "description": "" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 }, "description": "" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 120 }, "description": "Artiestennaam, of artiestennaam of releasetitel bij recensies en releases. De zoekterm moet letterlijk voorkomen; hoofdletters maken geen verschil. De volledige reviewtekst wordt niet doorzocht." }, { "name": "spotify_id", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[A-Za-z0-9]{22}$" }, "description": "Alleen gecontroleerde artiest- en release-ID’s leveren resultaten op. Onbevestigde koppelingen blijven buiten de resultaten." }, { "name": "spotify_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "artist", "album", "track" ] }, "description": "Optionele specificatie van het soort Spotify-ID. Vereist spotify_id." } ], "responses": { "200": { "description": "data.artists, data.releases en data.reviews bevatten elk data, meta en links.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "artists": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Artist" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } }, "releases": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Release" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } }, "reviews": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Review" } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "pages": { "type": "integer" } } }, "links": { "type": "object", "properties": { "self": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] } } } } } } }, "attribution": { "$ref": "#/components/schemas/Attribution" } } } } } }, "400": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "429": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "503": { "description": "JSON-foutmelding. Antwoorden bevatten geen interne gegevens.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }, "401": { "description": "Missing, invalid, revoked or deleted-account API key.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "403": { "description": "API access for the account is blocked." } } } }, "/": { "get": { "summary": "Authenticated API index", "responses": { "200": { "description": "API links and default limits." }, "401": { "description": "A valid API key is required." }, "403": { "description": "API access blocked." }, "429": { "description": "Rate limit reached." } } } } }, "components": { "schemas": { "Artist": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "url", "api_url", "spotify_id", "spotify_url" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "api_url": { "type": "string", "format": "uri" }, "spotify_id": { "type": [ "string", "null" ] }, "spotify_url": { "type": [ "string", "null" ] }, "reviews_url": { "type": "string", "format": "uri" }, "releases_url": { "type": "string", "format": "uri" } } }, "Release": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "type": { "enum": [ "album", "single", "ep", "live", "compilation" ] }, "release_date": { "type": [ "string", "null" ] }, "date_precision": { "enum": [ "day", "month", "year", "unknown" ] }, "url": { "type": "string", "format": "uri", "description": "Volledige canonieke pagina-URL: de gekoppelde openbare recensie als die beschikbaar is, anders de releasegids. Release- en API-ID’s blijven gelijk." }, "api_url": { "type": "string", "format": "uri" }, "artists": { "type": "array", "items": { "$ref": "#/components/schemas/Artist" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/Genre" } }, "reviews": { "type": "array", "maxItems": 3, "items": { "$ref": "#/components/schemas/ReviewPreview" } }, "reviews_url": { "type": "string", "format": "uri" }, "spotify": { "type": "array", "items": { "type": "object", "properties": { "type": { "enum": [ "album", "track" ] }, "id": { "type": "string" }, "url": { "type": "string", "format": "uri" } } } } } }, "Review": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 10 }, "excerpt": { "type": "string", "maxLength": 400 }, "url": { "type": "string", "format": "uri" }, "api_url": { "type": "string", "format": "uri" }, "type": { "enum": [ "album", "single" ] }, "score_scale": { "const": 10 }, "published_at": { "type": "string", "format": "date-time" }, "spotify": { "anyOf": [ { "type": "object", "properties": { "type": { "enum": [ "album", "track" ] }, "id": { "type": "string" }, "url": { "type": "string", "format": "uri" } } }, { "type": "null" } ] }, "artists": { "type": "array", "items": { "$ref": "#/components/schemas/Artist" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/Genre" } }, "release": { "anyOf": [ { "$ref": "#/components/schemas/Release" }, { "type": "null" } ] } } }, "ReviewPreview": { "type": "object", "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 10 }, "excerpt": { "type": "string", "maxLength": 400 }, "url": { "type": "string", "format": "uri" }, "api_url": { "type": "string", "format": "uri" } } }, "Genre": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" }, "api_url": { "type": "string", "format": "uri" } } }, "Attribution": { "type": "object", "properties": { "name": { "const": "GrooveGauge" }, "url": { "type": "string", "format": "uri" }, "required": { "const": true }, "instructions": { "type": "string" } } } }, "securitySchemes": { "ApiKeyAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "gg_live_<64 lowercase hex characters>", "description": "Create and manage keys at /nl/account/api/. Never put credentials in the query string." } } } }