Export Data Formats
Exporting Your Data from Simkl
Last updated
Was this helpful?
Exporting Your Data from Simkl
Last updated
Was this helpful?
Backing up and exporting your Simkl data ensures you always have a copy of your watch history, ratings, memos, and more. Simkl offers three primary export formats to suit a variety of needs:
Simple .CSV File Backup (Pro feature)
.zip Archive with JSON File (Pro feature)
Export via Simkl API (Free for all SIMKL Members)
It’s 100% free to use for everyone, the API to get all your data using that many apps use to export your watch history from SIMKL.
Pro members get access to specialized tool to export in specific easy to read format for excel - CSV files.
VIP members get access to automatic backups that api responds in (json format) to your email or google drive once a month.
The Simple CSV backup is ideal for users who want a quick snapshot of their watchlist. It includes only the last watched episode for each TV show or anime, without detailed per-episode records. This format is great for spreadsheet analysis or as a lightweight backup.
Simkl ID: Unique identifier for each title.
Title: Show or movie name.
Watchlist Status: (watching
, plan to watch
, completed
, etc.).
WatchedDate: Date and time when the last episode was watched.
And few other details
Go to your Simkl Apps → Export → Backup.
Under Simple .CSV file backup, click Download Backup.
Save the CSV file to your computer.
The JSON export provides a comprehensive backup of your entire Simkl history. All your data is packaged into a single ZIP archive for portability.
User Profile: Account metadata.
Full list of Movies, TV shows and anime, Watchlist with ratings, etc.
Memos: Personal notes on episodes and titles.
External IDs: simkl
, tvdb
, imdb
, etc.
Go to your Simkl Apps → Export → Backup..
Click Download Backup under the .zip archive with .json file.
Extract the ZIP on your device to access the JSON file.
For developers or power users, the Simkl API allows on‑demand data exports and integration with custom tools. With API access, you can programmatically retrieve your watchlist, history, and metadata in JSON format.
JSON API DOCS: See API Get All items
type: anime
, tv
, or movie
status: watching
, plan to watch
, completed
, dropped
, on hold
date_from (optional): ISO 8601 date to only return items updated after this timestamp
extended (optional): full
to include episode lists; omit for minimal data
episode_watched_at (optional): yes
to include watch timestamps per episode
memos (optional): yes
to include user memos
Real‑time exports without visiting the website.
Ideal for creating personal dashboards or syncing with home media servers.
Highly customizable with query parameters.
Exporting your Simkl data safeguards your watch history and empowers you to analyze or migrate it as needed.
Whether you prefer the simplicity of a CSV, the completeness of a JSON backup, or the flexibility of the API, Simkl has you covered.
Always keep a recent export on hand to ensure you never lose track of your viewing journey!
Possible values: