Skip to main content
GET
/
api
/
deep-search
Deep Search
curl --request GET \
  --url https://api.example.com/api/deep-search
{
  "[array]": [
    {
      "id": "<string>",
      "slug": "<string>",
      "titulo": "<string>",
      "alt": "<string>",
      "imagen": "<string>",
      "year": "<string>",
      "generos": "<string>",
      "idioma": "<string>",
      "tipo": "<string>",
      "url": "<string>"
    }
  ],
  "error": "<string>"
}

Endpoint

GET /api/deep-search

Description

Performs a deep search across the entire content catalog using the source website’s native search functionality. This provides more comprehensive results than the quick search available in the /api/listado endpoint.

Parameters

query
string
required
Search query string. Cannot be empty.

Response

Returns an array of content items directly (not wrapped in an object).
[array]
array
required
Array of content items matching the search query

Error Response

error
string
Error message describing what went wrong

Example Requests

curl "http://localhost:1234/api/deep-search?query=avengers"

Example Response

Success Response

[
  {
    "id": "11223",
    "slug": "avengers-endgame",
    "titulo": "Avengers: Endgame",
    "alt": "Avengers: Endgame",
    "imagen": "https://example.com/endgame.jpg",
    "year": "2019",
    "generos": "Action, Adventure, Sci-Fi",
    "idioma": "Latino",
    "tipo": "pelicula",
    "url": "https://sololatino.net/peliculas/avengers-endgame"
  },
  {
    "id": "44556",
    "slug": "avengers-infinity-war",
    "titulo": "Avengers: Infinity War",
    "alt": "Avengers: Infinity War",
    "imagen": "https://example.com/infinitywar.jpg",
    "year": "2018",
    "generos": "Action, Adventure, Sci-Fi",
    "idioma": "Latino",
    "tipo": "pelicula",
    "url": "https://sololatino.net/peliculas/avengers-infinity-war"
  }
]

Error Responses

Missing Query Parameter

{
  "error": "Falta el parámetro de búsqueda"
}
Status: 400 Bad Request

Service Unavailable

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

Search Failed

{
  "error": "No se pudo realizar la búsqueda profunda: Connection timeout"
}
Status: 500 Internal Server Error
  • Uses the source website’s AJAX search API
  • Faster response time
  • Good for autocomplete/suggestions
  • Returns results wrapped with metadata
  • Limited to top results

URL Encoding

The search query is automatically URL-encoded, so spaces and special characters are handled correctly:
# These are equivalent:
curl "http://localhost:1234/api/deep-search?query=spider man"
curl "http://localhost:1234/api/deep-search?query=spider%20man"

Build docs developers (and LLMs) love