Skip to main content
GET
/
search
/
{type}
curl -H "User-Agent: my-app-name/1.0" \ "https://api.simkl.com/search/movie?q=john+wick&limit=2&client_id=YOUR_CLIENT_ID&app-name=my-app-name&app-version=1.0"
[ { "title": "John Wick", "year": 2014, "endpoint_type": "movies", "poster": "30/3002370dbc564e5d8", "ids": { "simkl_id": 342994, "slug": "john-wick", "tmdb": "245891" } }, { "title": "John Wick: Chapter 4", "year": 2023, "endpoint_type": "movies", "poster": "13/13693559ce304eb6f6", "ids": { "simkl_id": 1098350, "slug": "john-wick-chapter-4", "tmdb": "603692" } } ]

Documentation Index

Fetch the complete documentation index at: https://api.simkl.org/llms.txt

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

Authorizations

​
client_id
string
query
default:YOUR_CLIENT_ID
required

Preferred form: your client_id as a URL query parameter on every request. Self-describing in logs and curl commands. See Headers and required parameters.

Headers

​
User-Agent
string
required

Descriptive identifier for your app, ideally name/version. Examples: PlexMediaServer/1.43.1.10540, kodi-simkl/0.9.2, MyApp/2.4.1 (https://myapp.com).

Path Parameters

​
type
enum<string>
required

Search type.

Available options:
tv,
anime,
movie

Query Parameters

​
q
string
required

Required. The search term — matches title and all_titles[] across the chosen catalog (movies / TV / anime).

Examples: john wick, john wick 2014, breaking bad, cowboy bebop.

​
page
integer
default:1

Page number for paginated endpoints (1-based).

Required range: 1 <= x <= 20
​
limit
integer
default:10

Items per page. Capped at 50.

Required range: 1 <= x <= 50
​
extended
enum<string>

full adds overview, ratings, and genres to each match.

Available options:
simple,
full
​
client_id
string
required

Your client_id from your Simkl developer settings. Required on every request.

​
app-name
string
required

Short, lowercase identifier for your app (e.g. plex-scrobbler, kodi-bridge). Helps Simkl identify which apps are using the API.

​
app-version
string
required

Your app's current version (e.g. 1.0, 2.4.1). Helps Simkl debug issues you report.

Response

OK

One movie search result. endpoint_type is the constant "movies" (plural even though the path is /search/movie). Extended fields (all_titles, url, rank, ratings) only appear when the call includes extended=full.

​
title
string
required
​
year
integer
required
​
endpoint_type
enum<string>
required

Constant for movie search results.

Available options:
movies
​
poster
string | null
required

Image path fragment. Combine with the prefixes in Image conventions — for example https://simkl.in/posters/{poster}_m.webp. Type 4 null — null when no poster image is on file. See Null and missing values.

​
ids
object
required

ID block returned on every search result item. simkl_id and slug are always present; tmdb is only present when a TMDB link record exists for the title.

​
all_titles
string[]

Aliases / localized variants. Extended mode only, and only when the catalog has more than one title.

​
url
string

Relative simkl.com URL. Extended mode only.

​
rank
integer | null

Simkl popularity rank. Type 4 null — null when the item is not yet ranked or the catalog sentinel value (≥ 999999) is present. See Null and missing values.

​
ratings
object

External-source ratings block. Each sub-key is present only when the corresponding rating record exists.