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 genre endpoint powers the genre filter section on the VinylVibes main page. When the page loads, the frontend initializes a row of 10 genre buttons and immediately fetches the first page of the default genre. Subsequent genre selections call this endpoint, and results are cached in memory for the duration of the session to avoid redundant requests.

GET /genero/

Returns a paginated list of vinyl records belonging to a specific genre. The frontend renders 20 items per page and displays pagination controls below the genre grid when more than one page is available.

Path parameter

ParameterTypeDescription
genrestringURL-encoded genre name. Must be one of the 10 supported values listed below.

Query parameter

pagina
integer
Page number to retrieve. Defaults to 1 if omitted.

Supported genres

The following are the only accepted values for the {genre} path segment, matching the GENEROS_FIJOS constant defined in script.js: Rock · Jazz · Pop · Electronic · Hip Hop · Classical · Blues · Folk · Latin · Reggae

Example request

curl 'https://api-tienda-vinilos.onrender.com/genero/Jazz?pagina=1'

Response fields

resultados
array
Array of vinyl objects for the requested page. Each object has the same shape as items returned by /recientes: discogs_id, titulo, artista, imagen_url, precio, and genero.
paginas
integer
Total number of pages available for this genre.
pagina
integer
The current page number reflected back in the response.

Response example

{
  "resultados": [...],
  "paginas": 3,
  "pagina": 1
}
The frontend renders 20 items per page (ITEMS_POR_PAGINA = 20). Pagination controls — ← Anterior and Siguiente → — are rendered below the genre grid whenever paginas is greater than 1.

Build docs developers (and LLMs) love