What is in a Snapchat data export, and how to read the chats
You asked Snapchat for your data, and you got one or more files called mydata~….zip. Your chats are in there, but not as chats. They are one data file and one folder of media. This page explains what each part is.
What the download contains
| Folder or file | What it is |
|---|---|
json/chat_history.json | Every chat message Snapchat exported, grouped by friend or group |
json/snap_history.json | A log of snaps sent and received: who and when, no content |
json/friends.json, json/account.json | Your friends’ usernames and display names, and your own username |
html/ and index.html | Snapchat’s own pages for the same data |
chat_media/ | The photos, videos and voice notes saved in chats, all in one folder |
memories/ | Your saved Memories, if you asked for them |
The json folder is only there if you turned on Export JSON Files when you requested the export. Without it, a tool has nothing reliable to read.
How chat_history.json is built
The file is one object. Each key is a conversation: a friend’s username for a one-to-one chat, or a long ID for a group. Each value is the list of messages.
{
"alice.w": [
{
"From": "alice.w",
"Media Type": "MEDIA",
"Created": "2024-03-14 15:31:00 UTC",
"Content": "",
"Conversation Title": null,
"IsSender": false,
"Created(microseconds)": 1710430260000,
"IsSaved": true,
"Media IDs": "b~EiQSFTM0SEdmSTFNRzBDdkhlelFQS1hLUhoAGgAyAXxIAlAEYAE"
}
]
}| Field | What it means |
|---|---|
From | Username of the person who sent the message |
IsSender | true when you sent it |
Media Type | TEXT, MEDIA (photo or video), NOTE (voice note), STICKER, SHARE, or a status line such as STATUSERASEDMESSAGE |
Created | Date and time in UTC |
Created(microseconds) | The same moment as a number. Despite the name, exports usually hold milliseconds here |
Content | The text. Empty for media |
Conversation Title | The name of a group chat. Empty for one-to-one chats |
IsSaved | Whether the message was saved in the chat |
Media IDs | The IDs of the files sent with the message. Several IDs are separated by | |
Messages are not guaranteed to be in order, so a reader has to sort them by time.
Why the media files have unreadable names
Every file in chat_media is named with a date and an ID:
2024-03-14_b~EiQSFTM0SEdmSTFNRzBDdkhlelFQS1hLUhoAGgAyAXxIAlAEYAE.jpg
2024-03-15_media~zip-38FDD84B-5891-4975-84BD-08763E785D32.mp4
2024-03-15_overlay~zip-31FBA148-B00D-4E1D-A802-25249ADDF1A8.png
2024-03-18_thumbnail~zip-C07EF7F5-9005-43FE-83C2-9CA9F173CA3E.jpg- The part after the date is the media ID. For files that start with
b~, it is the same text that a message lists underMedia IDs. That is the link between a message and its photo. - The name does not say who sent it. Without the JSON you cannot tell which friend or chat a file belongs to.
- Some files are in no message. Files named
media~,overlay~orthumbnail~are extra copies, the drawing or caption layer of a snap, or a preview image. No message lists them. - Voice notes are video files. A voice note arrives as an
.mp4with sound and no picture. The message typeNOTEtells you it is one.
Why only saved chats are in the export
Snapchat is built to delete chats. By default a message is removed from Snapchat’s servers after everyone has viewed it or after it expires. What stays is what someone saved: messages kept in the chat and media saved in chat.
The export can only contain what Snapchat still has. So:
- Conversations where nobody saved anything can be empty or missing.
- A message can name a media ID whose file is not in the export. That photo or video is gone from the export, and no tool can recreate it.
- Snaps you opened and did not save are not there.
snap_history.jsononly lists that they existed.
How to request the export with chats and media
- Open Snapchat, tap your profile, then the gear icon for Settings. Choose My Data. You can also sign in at
accounts.snapchat.comand choose My Data there. - Turn on Export JSON Files. This is the step that matters: the conversations are read from the JSON.
- Turn on Chat History and the option to export chat media. You need both: the first gives the messages, the second gives the photos, videos and voice notes.
- Set the date range to all time, confirm your email address and submit.
- Snapchat emails you when the export is ready. Large accounts get several files named
mydata~….zip. Download all of them and do not unzip them.
Snapchat changes the labels on this screen from time to time. If a name here does not match what you see, look for the options about JSON, chat history and chat media.
Reading it without Python or Docker
The free tools that read this export are a Python package and a Docker project. They work, and they need a computer and a command line. ThreadTidy does the matching in the browser: you drop the ZIP files, it reads chat_history.json, matches each media ID to its file, and gives you one page per conversation with the media in place. Nothing is uploaded.
ThreadTidy only reads chats. If your problem is Memories with the wrong date, that is a different job: see Restamp.
Read your Snapchat chats now
Drop the ZIP files and get a page per conversation. Free for 2 conversations, $9 once for all. Nothing is uploaded.
Read my chats