/api/mcu
- Thomas Tornevall
Method: GET
Aliases: /api/mcu/timeline
Aliases: /api/mcu/timeline/category/n/
Primary endpoint for the MCU timeline. Sending requests to this endpoint will generate a full list of what's registered in the API. The response you'll get here is a huge json object with each category respectively.
By adding category/<num>/ you can choose to fetch separate categories only. See /api/mcu/categories for more information.
The columns displayed in each category section is much, with a few exceptions, all stored data. This could change over time, but currently, we present data for each category as:
| Column name | Column Type | Description |
|---|---|---|
| mcuid | int | Internal ID. |
| cid | int | Category ID. |
| sortorder | int | Our internal sort order, mostly used for things in the database that has exact same dates listed or where movie titles may have higher priority than the MCU timeline status. When it comes to "mcu time", some events in mcu occurance order could also be inaccurate, take place the same year, etc, that forces the sort order to have higher sorting priority. |
| title | string | Movie or tv series title. |
| extratitle | string | Will be used as an indicator that the title has a longer name. When this system is updated you will get the main title in the title, and the episode name in the extra title like this: Title: The Falcon and The Winter Soldier |
| keywords | string | Keywords that usually is searchable. |
| premiere | datetime | Registered premiere date, like the cinematic release. When dates are unknown or unsure, they will look like 0000-00-00 or 2021-00-00, depending on statistics and information this far. |
| mcutime | string | When this title takes place in mcu time count. Not a datetime column as movies may be run over several years and in the same time crosses by other movies. |
| tv | int/boolean | If title belongs to a tv series. |
| animated | int/boolean | If title is a tv-series and animated. |
| season | int | Season number. Titles are also usually marked itself as S0XE0Y so this column could be considered optional. |
| episode | int | Episode in season. Titles are also usually marked itself as S0XE0Y so this column could be considered optional. |
| imdb | string | Link to the movie at imdb.com - if this the title is a movie, it points to the movie itself. If the title is a tv-series, this url points to the primary season url. IMDB data will only be snatched when there is no prior data, so if updates has been made at imdb after the first snatch that data won't be updated. |
| imdbepisode | string | Link to each episode in each season. |
| distribution | string | Company that produced or distributed the title. |
| labeltype | string | Design data. Planned. |
| links | string | If there are urls of interest, they are probably put here. It is not yet decided if they will be published as json or a comma separated string. |
| contentinformation | longtext | If not empty, this is a json-string. Compared with the prior mcu-documentation, this is the part where extra information goes. For example extended information about the title - or which post credit scenes we expect to find. Example from a search for Captain America: "contentinformation": {
"Post": [
"Wanda and Pietro - The Twins - are introduced.",
"Hydra now has the scepter, a scene that will follow up in Age of Ultron.",
"Post credits ends with Bucky watching Captain America."
],
"Notes": [
"On your left.",
"Alternative Title: 'The Return of The First Avenger."
]
},
Post credit scenes are always marked as "Post", and extra notes are separated in "Notes". |
| collectionid | int | Id of the collection this title belongs in. |
| imdbcache | longtext | A huge block of json data fetched from imdb, with extended information about the title. For the moment, no tv series episodes are included here. |
| category | string | Remember cid from above? This is the name of the category linked to that id. |
| background | string | Background colour for each category (used by snapshot as a demonstration). Used when you can't decide yourself which background each category should have, and matches with the color scheme used by the old documents, to mark passed, upcoming and current phase. |
| csortorder | int | Sort order for category. |
| phase | int | Numeric if the title is set to a phase. Usually used to separated documentaries linked to a set of movies from the real phases. |
| collectionName | string | If title belongs to a collection, this is the name of that collection. |
| premiereUnix | int | The 32 bit value for the premiere date. Great to have when it comes to sorting out dates in numeric order. |
| ourSortOrder | array | The current sort order for how we show the data you get. |
| inserted | datetime | Timestamp when the entry was added to the database. Column can be used for keeping track of new and updated titles in a RSS system. |
| updated | datetime | Timestamp when the entry was updated. Column can be used for keeping track of new and updated titles in a RSS system. |