Skip to main content
GET
/
api
/
listado
Get Listado
curl --request GET \
  --url https://api.example.com/api/listado
{
  "resultados": [
    {
      "id": "<string>",
      "slug": "<string>",
      "titulo": "<string>",
      "title": "<string>",
      "alt": "<string>",
      "imagen": "<string>",
      "image": "<string>",
      "year": "<string>",
      "generos": "<string>",
      "idioma": "<string>",
      "tipo": "<string>",
      "type": "<string>",
      "url": "<string>",
      "language": "<string>"
    }
  ],
  "seccion": "<string>",
  "pagina": 123,
  "error": "<string>",
  "warning": "<string>"
}

Endpoint

GET /api/listado

Description

Retrieve a paginated list of movies, series, or anime from a specific section, or search for content by keyword. This is the primary endpoint for browsing and discovering content.

Parameters

seccion
string
The section to browse. Must be one of the sections returned by /api/secciones. Case-insensitive. Defaults to “Películas” if not provided.
pagina
integer
default:"1"
Page number for pagination. Starts at 1.
busqueda
string
Search keyword. When provided, performs a search instead of browsing by section. Overrides seccion and pagina parameters.

Response

resultados
array
required
Array of content items
seccion
string
required
The section name used for the query (or “Busqueda” for search)
pagina
integer
required
Current page number
error
string
Error message if the request fails
warning
string
Warning message for unexpected response formats

Example Requests

Browse by Section

curl "http://localhost:1234/api/listado?seccion=Netflix&pagina=1"

Search for Content

curl "http://localhost:1234/api/listado?busqueda=spider"

Example Response

Browse Response

{
  "resultados": [
    {
      "id": "12345",
      "slug": "the-batman-2022",
      "titulo": "The Batman",
      "alt": "The Batman",
      "imagen": "https://example.com/poster.jpg",
      "year": "2022",
      "generos": "Action, Crime, Drama",
      "idioma": "Latino",
      "tipo": "pelicula",
      "url": "https://sololatino.net/peliculas/the-batman-2022"
    }
  ],
  "seccion": "Películas",
  "pagina": 1
}

Search Response

{
  "resultados": [
    {
      "id": "67890",
      "slug": "spider-man-no-way-home",
      "title": "Spider-Man: No Way Home",
      "alt": "Spider-Man: No Way Home",
      "image": "https://example.com/spiderman.jpg",
      "year": "2021",
      "language": "Latino",
      "type": "movie"
    }
  ],
  "seccion": "Busqueda",
  "pagina": 1
}

Error Responses

Section Not Found

{
  "error": "Sección no encontrada"
}
Status: 404 Not Found

Failed to Fetch HTML

{
  "error": "No se pudo obtener HTML para la página."
}
Status: 500 Internal Server Error

Search Service Unavailable

{
  "error": "No se pudo obtener respuesta de búsqueda"
}
Status: 503 Service Unavailable

Notes

  • Section names are case-insensitive and accent-insensitive
  • Search uses the internal search API of the source website
  • Search results return page 1 only, regardless of the pagina parameter
  • The K-Drama section has a different URL structure for pagination
  • Browse results include more detailed metadata than search results

Build docs developers (and LLMs) love