Skip to main content
GET
/
anime
/
premieres
/
{param}
curl -H "User-Agent: my-app-name/1.0" \ "https://api.simkl.com/anime/premieres/new?client_id=YOUR_CLIENT_ID&app-name=my-app-name&app-version=1.0"
[ { "title": "Kidou Keisatsu Patlabor EZY", "year": 2026, "date": "2026-05-15T00:00:00+09:00", "url": "/anime/693329/kidou-keisatsu-patlabor-ezy", "poster": "19/193846462efc60a35a", "ids": { "simkl_id": 693329, "slug": "kidou-keisatsu-patlabor-ezy" }, "anime_type": "movie", "rank": null, "ratings": { "simkl": { "rating": 10, "votes": 1 }, "mal": { "rating": 0, "votes": 0 } } } ]

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

​
param
enum<string>
required

new for recent releases (sorted newest first), soon for upcoming titles (sorted soonest first). Anything other than new behaves like soon.

Available options:
new,
soon

Query Parameters

​
type
enum<string>

Optional. Narrow by anime format. Unknown values are ignored.

Available options:
all,
tv,
movies,
ovas,
onas,
music
​
page
integer

Page number (1-based). Maximum 20.

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

Items per page. Maximum 60 — higher values are reduced to 60.

Required range: 1 <= x <= 60
​
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 — array of items. Shape depends on {param} (see oneOf branches).

Items returned when you call /tv/premieres/new or /anime/premieres/new. Includes rank and ratings on top of the base fields. Anime items also carry anime_type.

​
title
string
required

Display title.

​
date
string
required

Release date as an ISO-8601 timestamp with timezone offset. TV uses -05:00, anime uses +09:00 (Japan time).

Example:

"2026-05-18T00:00:00-05:00"

​
url
string
required

simkl.com URL relative to the root, with the slug appended. Non-ASCII characters in the slug come URL-encoded — don't encode them a second time.

Example:

"/tv/2750099/you%E2%80%99re-killing-me"

​
ids
object
required

simkl_id and slug are always present.

​
year
integer | null

Type 4 null — release date isn't known yet. See Null and missing values. Otherwise the premiere year as an integer.

​
poster
string | null

Type 4 null — no poster on file. See Null and missing values. When present, it's an image path fragment — build the full URL using the patterns in Image conventions (e.g. https://simkl.in/posters/{poster}_m.webp).

​
anime_type
enum<string>

Anime catalog items only. Catalog format.

Available options:
tv,
movie,
ova,
ona,
special,
music
​
rank
integer | null

Type 4 null — title isn't ranked yet. See Null and missing values. When present, the Simkl popularity rank (lower is more popular).

​
ratings
object

Aggregate ratings. Always carries simkl. TV items carry imdb; anime items carry mal.