reality.app APIreality.app ↗
Access live streaming event listings, detailed event information, and participant rankings from the REALITY virtual platform to discover shows and track leaderboard standings. Build applications that keep users informed about upcoming events and help them monitor competitive results in real-time.
No input parameters required.
curl -X POST 'https://api.parse.bot/scraper/8d14cfba-9676-4392-9222-ffae438647c0/list_events' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Typed Python client. Install the CLI, sign in, then pull this API’s generated client:
pip install parse-sdk parse login parse add --marketplace reality-app-api
parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: REALITY App Events SDK — browse events, fetch details, check leaderboards."""
from parse_apis.REALITY_App_Events_API import Reality, NotFoundError
client = Reality()
# List event summaries — limit= caps TOTAL items fetched.
for event in client.event_summaries.list(limit=3):
print(event.title, event.event_type, event.begin_at)
# Drill-down: get full event detail from a summary.
summary = client.event_summaries.list(limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.thresholds, detail.show_score)
# Fetch an event directly by ID and browse its leaderboard.
try:
event = client.events.get(event_id="23542")
print(event.title, event.begin_at, event.end_at)
except NotFoundError as exc:
print(f"Event not found: {exc}")
# Iterate leaderboard participants for that event.
if event:
for participant in event.results(limit=5):
print(participant.rank, participant.nickname, participant.score)
print("exercised: event_summaries.list / summary.details / events.get / event.results")
List all broadcaster events on REALITY platform. Returns the full catalog of past and present events with summary metadata including dates, thresholds, and category. No pagination — returns all events in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer",
"events": "array of event summaries"
},
"sample": {
"data": {
"total": 881,
"events": [
{
"title": "【イベント終了】REALITY × あおぎり高校 YouTube Shorts コラボ出演争奪戦！Vol.2",
"end_at": "2025-12-21T15:00:00Z",
"status": 3,
"open_at": "2025-12-05T09:00:00Z",
"begin_at": "2025-12-15T09:00:00Z",
"close_at": "2026-06-21T15:00:00Z",
"event_id": 21752,
"icon_url": "https://image-api.reality.wrightflyer.net/api/v1/image/event-icon/21752/1761880742",
"page_url": "https://reality.app/events/21752",
"event_type": 1,
"thresholds": [
0
],
"category_id": 0,
"internal_title": "REALITY × あおぎり高校 YouTube Shorts コラボ出演争奪戦！Vol.2",
"header_image_url": "https://image-api.reality.wrightflyer.net/api/v1/image/event-header/21752/1761880743",
"number_of_groups": 1,
"number_of_winners": 1
}
]
},
"status": "success"
}
}About the reality.app API
The reality.app API on Parse exposes 3 endpoints for the publicly available data on reality.app. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.