The Search API lets you find items in Simkl’s catalog. All endpoints accept aDocumentation Index
Fetch the complete documentation index at: https://api.simkl.org/llms.txt
Use this file to discover all available pages before exploring further.
client_id only — no user token required — and return Standard Media Objects.
Got an external ID already? Don’t search — use
/redirect to resolve it to a Simkl ID, then fetch the full record from /movies/{id}, /tv/{id}, or /anime/{id} (Cloudflare-cached by Simkl ID, much cheaper for repeat lookups). Search endpoints are for cases where you only have a title string, a file name, or want a random pick.| Endpoint | What it does |
|---|---|
GET /search/{type} | Free-text search across movie, tv, or anime. |
POST /search/file | Identify a movie or episode from a file name (great for media servers). |
POST /search/random | Pick a random item, optionally filtered by genre, year, rating, etc. |
By text
GET /search/{type} — search by title.By file
POST /search/file — identify content from a file name.Random
POST /search/random — pick a random item.