Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/akibanks/api-tienda-vinilos/llms.txt

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

Retrieve up to 20 vinyl releases added to Discogs during the current calendar year, sorted by date_added in descending order so the newest additions appear first. This endpoint is ideal for powering a “New Arrivals” or “Fresh Stock” section in your storefront. The result is cached in Redis under the key recientes for 24 hours — the cache is shared across all users and is invalidated automatically when it expires.
The current year is determined at request time on the server. The cache is refreshed at most once every 24 hours, so releases added to Discogs within that window may not appear immediately.

Endpoint

PropertyValue
MethodGET
Path/recientes
AuthNone
Cache TTL24 hours (shared)

Request Parameters

This endpoint accepts no query parameters.

Response Fields

The response is a JSON array of up to 20 release objects. Each object has the same shape as a result item from GET /buscar.
[n]
object
A release object.

Example Request

curl https://api.vinylvibes.example.com/recientes

Example Response

[
  {
    "discogs_id": "28471933",
    "titulo": "Bright Future",
    "artista": "Adrianne Lenker",
    "anio": 2024,
    "genero": "Folk, World, & Country",
    "estilo": "Folk",
    "imagen_url": "https://i.discogs.com/bright-future-cover.jpg",
    "precio": 19.99,
    "have": 1240,
    "want": 890
  },
  {
    "discogs_id": "28109847",
    "titulo": "Chromakopia",
    "artista": "Tyler, the Creator",
    "anio": 2024,
    "genero": "Hip Hop",
    "estilo": "Conscious",
    "imagen_url": "https://i.discogs.com/chromakopia-cover.jpg",
    "precio": 19.99,
    "have": 4310,
    "want": 7850
  }
]

Error Responses

StatusError messageCause
500"Error al obtener discos recientes."Discogs API request failed or returned an error.

Build docs developers (and LLMs) love