Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/akibanks/tienda_musica_web/llms.txt

Use this file to discover all available pages before exploring further.

The catalog endpoints power the main VinylVibes storefront. They return vinyl records sourced from Discogs, enriched with Last.fm artist biographies and YouTube video links. The album detail modal fetches /disco/{id}, /historia, /video, and /recomendaciones in parallel to populate all sections of the UI without blocking the initial render.

​
GET /recientes

Returns the most recently added vinyl records. Used to populate the homepage carousel and the Novedades & Historias editorial section. No authentication is required.

​
Example request

curl https://api-tienda-vinilos.onrender.com/recientes

​
Response

An array of vinyl objects. Each object contains the following fields:
​
discogs_id
string
The Discogs release ID. Used as the primary identifier across all catalog endpoints.
​
titulo
string
Album title.
​
artista
string
Artist name.
​
imagen_url
string
URL of the album cover image served from Discogs.
​
precio
number
Price in USD.
​
genero
string
Primary genre tag (e.g. "Jazz", "Rock").

​
Response example

[
  {
    "discogs_id": "12345",
    "titulo": "Kind of Blue",
    "artista": "Miles Davis",
    "imagen_url": "https://...",
    "precio": 29.99,
    "genero": "Jazz"
  }
]

​
GET /disco/

Returns full detail for a single vinyl record by its Discogs ID. This is the first call the album detail modal makes before firing the enrichment endpoints in parallel.

​
Path parameter

ParameterTypeDescription
discogsIdstringThe Discogs release ID of the record to retrieve.

​
Example request

curl https://api-tienda-vinilos.onrender.com/disco/12345

​
Response fields

​
discogs_id
string
The Discogs release ID.
​
titulo
string
Album title.
​
artista
string
Artist name.
​
imagen_url
string
URL of the album cover image.
​
precio
number
Price in USD.
​
genero
string
Primary genre tag.
​
estilo
string
Sub-genre or style tag (e.g. "Hard Bop", "Classic Rock"). May be null.

​
GET /disco//historia

Returns the artist biography and album story text. This content is displayed in the storytelling modal view triggered from the Novedades & Historias section. The frontend sends the request without authentication headers — no token is required or sent for this endpoint.

​
Path parameter

ParameterTypeDescription
discogsIdstringThe Discogs release ID.

​
Example request

curl https://api-tienda-vinilos.onrender.com/disco/12345/historia

​
Response fields

​
cuerpo
string
Biography and story text for the album’s artist. Rendered as plain text in the storytelling modal.

​
GET /disco//video

Returns a YouTube video identifier associated with the album. The frontend uses the youtube_id field to construct an iframe embed URL inside the album detail modal. If no video is found, the modal renders a placeholder instead.

​
Path parameter

ParameterTypeDescription
discogsIdstringThe Discogs release ID.

​
Example request

curl https://api-tienda-vinilos.onrender.com/disco/12345/video

​
Response fields

​
youtube_id
string | null
The YouTube video ID (e.g. "dQw4w9WgXcQ"). The frontend embeds it as https://www.youtube-nocookie.com/embed/{youtube_id}?rel=0&modestbranding=1. Returns null if no video is available.

​
GET /disco//recomendaciones

Returns personalized vinyl recommendations based on the album currently being viewed. The frontend sends the JWT from localStorage if one exists, but the request is also accepted without a token — authentication is optional.

​
Path parameter

ParameterTypeDescription
discogsIdstringThe Discogs release ID of the album being viewed.

​
Authentication

Optional. If a JWT is stored in localStorage, the frontend includes it in the Authorization header to allow the backend to personalize results. Unauthenticated requests are also accepted. 
curl https://api-tienda-vinilos.onrender.com/disco/12345/recomendaciones \
  -H 'Authorization: Bearer <token>'

​
Response

An array of vinyl objects, each with the same shape as items returned by /recientes (discogs_id, titulo, artista, imagen_url, precio, genero).

Build docs developers (and LLMs) love

Get started for freeTalk to us