TV shows airing today, tomorrow, or on a specific date
Currently airing TV shows — same data that powers the Simkl TV calendar. No access_token required.
Same shape and parameters as /anime/airing but for the TV catalog: no anime_type field, and the per-item episode block includes a season integer.
Query parameters
| Param | Default | Notes |
|---|---|---|
date | today | today, tomorrow, or DD-MM-YYYY. Bogus values silently fall back to today. |
sort | time | time, rank, popularity. Bogus values silently fall back to time. |
Item shape
{
"title": "string",
"year": "integer | null (extracted from the episode air time)",
"date": "ISO-8601 string with -05:00 offset | null",
"poster": "string (relative path; prepend https://simkl.in/posters/ + size)",
"rank": "integer | null (Simkl popularity rank; null when not yet ranked)",
"url": "string (relative simkl.com URL)",
"ids": {
"simkl_id": "integer",
"slug": "string"
},
"episode": {
"season": "integer",
"episode": "integer",
"url": "string"
}
}
Nulls — what they mean
| Field | When null | Type |
|---|---|---|
date | Catalog has no Airs_Time on file for this episode (rare — usually older or low-data titles) | Type 4 |
rank | Item not yet ranked, or rank value >= 999999 sentinel | Type 4 |
Error responses
| Status | When |
|---|---|
412 client_id_failed | Missing or invalid client_id |
500 | Server error |
No 400 — invalid date/sort values silently fall back to defaults. No 404 — empty result is [] with status 200.
Authorizations
Optional alias for the client_id query parameter. Simkl accepts your client_id either as the simkl-api-key request header or as the ?client_id=… query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.
Headers
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).
Query Parameters
only data within this date
^(today|tomorrow|\d{2}-\d{2}-\d{4})$sort the results by the specified option
time, rank, popularity Your client_id from your Simkl developer settings. Required on every request.
Short, lowercase identifier for your app (e.g. plex-scrobbler, kodi-bridge). Helps Simkl identify which apps are using the API.
Your app's current version (e.g. 1.0, 2.4.1). Helps Simkl debug issues you report.
Response
OK
Year extracted from the episode's Airs_Time. Type 4 null when no air time on file. See Null and missing values.
Episode air time as ISO-8601 with -05:00 offset (Simkl's server timezone). Type 4 null — catalog has no Airs_Time for this episode (rare; older or low-data titles). See Null and missing values.
Image path fragment. Combine with the prefixes in Image conventions — for example https://wsrv.nl/?url=https://simkl.in/posters/{poster}_m.webp&q=90.
Simkl popularity rank. Type 4 null when not yet ranked or when the catalog sentinel value (>= 999999) is present. See Null and missing values.
Relative simkl.com URL.