Browser Check
In an effort to deter bots, we now require automatic validation of your browser when visiting this site. You may be required to complete a challenge as part of this process.Latest Notifications
Americas
America/Chicago00:00
Europe
Europe/Paris00:00
East Asia
Australia/Sydney00:00
Historical Data
Americas |
---|
Loading... |
Europe |
---|
Loading... |
East Asia |
---|
Loading... |
West Asia |
---|
Loading... |
Moments
When BeReal sends out a notification in a particular region for the day, that event can be referred to as a "moment". You may also see this terminology used interchangeably with "notification(s)". "moment" is the technical term referenced in the BeReal API.
Data Collection
My server network asks BeReal for the latest moments in each region once per second and records new data as it becomes available; This means that my database is always up to date. I started collecting data in early September. As such, I am unable to provide any accurate data from an earlier time. To view my data, you can visit this site; On the dashboard tab, you can see the latest moments, as well as 90 days of history in each region respectively.
Why?
I started this project to help myself better understand how BeReal operates, and to make it easier for me to post my BeReals on-time. I continue to work on it because collecting data like this has allowed me to explore ways of visualizing and applying data in real-world applications. I do all of this on my own time, and I don't make any profits from it. If you appreciate what I have made and would like to help fund the project, you can donate to my Ko-Fi page using the widget in the bottom left corner of your screen.
BeReal Time History API
You can integrate real time and historic moment data into your own project. To get started, you'll need to request an API key. This is unique to your project and should not be shared.
V1 Documentation
All requests should be directed towards the following domain. Do not use the endpoints utilized by this web application, as they are rate limited and intended for this site only.
https://bereal.devin.rest/
To use the API, you need to supply an API key with each request. Please include the API key as a query parameter with the key name `api_key`, like so:
https://bereal.devin.rest/v1/moments/latest?api_key=YOUR_API_KEY
Both endpoints accept the GET http method.
/v1/moments/latest
GET Parameters
Name | Required | Value |
---|---|---|
api_key | Yes | Your personal API Key |
Returns the most recent moments in each region with the following JSON format:
{
"regions": {
"us-central": {
"id": "MIB0Amg220yP7m0Te-p9s",
"ts": "1677871105",
"utc": "2023-03-03 19:18:25"
},
"europe-west": {
"id": "CMDRw4EAAVJbz7LQLt35w",
"ts": "1677846583",
"utc": "2023-03-03 12:29:43"
},
"asia-west": {
"id": "ZzR8YsOxZ6N-5JIY69UUw",
"ts": "1677837621",
"utc": "2023-03-03 10:00:21"
},
"asia-east": {
"id": "GSB1g5Ef39pRsdL0VZfPB",
"ts": "1677886896",
"utc": "2023-03-03 23:41:36"
}
},
"now": {
"ts": 1677897828,
"utc": "2023-03-04 02:43:48"
}
}
/v1/moments/all
GET Parameters
Name | Required | Value |
---|---|---|
api_key | Yes | Your personal API Key |
limit | No | Limits the results per region (most recent first). Default is 90. Limit can be removed by entering "NONE" as the value. |
format | No | Changes the format of your data. Default is JSON. Options: "JSON", "CSV". |
Returns a collection of recent/all moments based on the parameters you set. Below is an example of the JSON format. You can see what the CSV format will look like by going to the dashboard tab, scrolling down to the "Historical Data" section, and exporting a CSV.
{
"regions": {
"us-central": [
{
"id": "MIB0Amg220yP7m0Te-p9s",
"ts": "1677871105",
"utc": "2023-03-03 19:18:25"
},
... TRUNCATED ARRAYS FOR DEMO ...
],
"europe-west": [
{
"id": "CMDRw4EAAVJbz7LQLt35w",
"ts": "1677846583",
"utc": "2023-03-03 12:29:43"
},
...
],
"asia-west": [
{
"id": "ZzR8YsOxZ6N-5JIY69UUw",
"ts": "1677837621",
"utc": "2023-03-03 10:00:21"
},
...
],
"asia-east": [
{
"id": "GSB1g5Ef39pRsdL0VZfPB",
"ts": "1677886896",
"utc": "2023-03-03 23:41:36"
},
...
]
}
}
/v1/moments/lookup
GET Parameters
Name | Required | Value |
---|---|---|
api_key | Yes | Your personal API Key |
time_zone | Yes | A list of supported time zones can be found here. You can find the origin time zone for each region on the dashboard. |
date | Yes | Must be in YYYY-MM-DD format. The result will return the moment which occurred on this date within timezone you select. (Other endpoints return timestamps in UTC) |
region | Yes | You can use any of these four supported regions: ["us-central", "europe-west", "asia-east", "asia-west"] |
Returns the most recent moments in each region with the following JSON format: ("America/Chicago" was the input for "time_zone" GET parameter in this example)
If there is no data for a particular query, the "id" key will return with the value "NO_DATA". This may happen if the date you provide falls before data began being collected, or if the moment for a particular date has not yet occurred.
{
"region": "us-central",
"id": "fz6OtUFp_elQJrGB2Rxkh",
"UTC": {
"unix": 1677963232,
"timestamp": "2023-03-04 20:53:52"
},
"localized": {
"timezone": "America\/Chicago",
"timestamp": "2023-03-04 14:53:52"
}
}
Contact The Developer
Hi, I'm Devin.
Send me an email at devin@devinbaeten.com if you have any questions, comments, or concerns. I'd love to hear from you!