JKT48 Showroom API Documentation
v3.0.14
Get real-time information about JKT48 members and official accounts currently live on Showroom.
Base URL:
https://api.jkt48connect.my.id/api/liveOverview
The JKT48 Showroom API provides real-time information about JKT48 members and official accounts currently streaming live on the Showroom platform. Access live stream data including room IDs, viewers count, and stream details.
Features
- Real-time live stream detection
- JKT48 member-specific data
- Official JKT48 account coverage
- Viewer count and engagement metrics
Quick Start
Make a GET request to:
https://api.jkt48connect.my.id/api/live/showroom?api_key=YOUR_API_KEYEndpoints
Get Live Showroom Data
Endpoint
GET /showroomQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API authentication key |
Example Request
GET https://api.jkt48connect.my.id/api/live/showroom?api_key=YOUR_API_KEYSuccessful Response
{
"success": true,
"timestamp": "2025-04-06T14:30:45Z",
"count": 2,
"lives": [
{
"name": "Gita Sekar Andarini",
"roomId": "318064",
"roomUrlKey": "gita_jkt48",
"isLive": true,
"viewers": 1243,
"startedAt": "2025-04-06T13:45:22Z",
"thumbnailUrl": "https://image.showroom-cdn.com/showroom-prod/image/room/318064_thumbnail.jpg",
"isOfficial": true
},
{
"name": "JKT48 Official",
"roomId": "317778",
"roomUrlKey": "jkt48_official",
"isLive": true,
"viewers": 3682,
"startedAt": "2025-04-06T14:00:00Z",
"thumbnailUrl": "https://image.showroom-cdn.com/showroom-prod/image/room/317778_thumbnail.jpg",
"isOfficial": true
}
]
}Error Response
Status Code: 401 Unauthorized
{
"success": false,
"error": "Invalid or missing API key. Please provide a valid API key."
}Status Code: 500 Internal Server Error
{
"success": false,
"error": "An error occurred while fetching data from Showroom API. Please try again later."
}Usage Examples
Getting Live Showroom Data
// Example Request
GET https://api.jkt48connect.my.id/api/live/showroom?api_key=your_api_key_here
// Example Response (when members are live)
{
"success": true,
"timestamp": "2025-04-06T14:30:45Z",
"count": 2,
"lives": [
{
"name": "Gita Sekar Andarini",
"roomId": "318064",
"roomUrlKey": "gita_jkt48",
"isLive": true,
"viewers": 1243,
"startedAt": "2025-04-06T13:45:22Z",
"thumbnailUrl": "https://image.showroom-cdn.com/showroom-prod/image/room/318064_thumbnail.jpg",
"isOfficial": true
},
{
"name": "JKT48 Official",
"roomId": "317778",
"roomUrlKey": "jkt48_official",
"isLive": true,
"viewers": 3682,
"startedAt": "2025-04-06T14:00:00Z",
"thumbnailUrl": "https://image.showroom-cdn.com/showroom-prod/image/room/317778_thumbnail.jpg",
"isOfficial": true
}
]
}
// Example Response (when no members are live)
{
"success": true,
"timestamp": "2025-04-06T03:15:22Z",
"count": 0,
"lives": []
}Using JavaScript (Fetch API)
const API_KEY = 'your_api_key_here';
fetch('https://api.jkt48connect.my.id/api/live/showroom?api_key=' + API_KEY)
.then(response => response.json())
.then(data => {
if (data.success) {
if (data.count > 0) {
console.log('There are currently ' + data.count + ' JKT48 streams live:');
data.lives.forEach(live => {
console.log('- ' + live.name + ' with ' + live.viewers + ' viewers');
console.log(' Room link: https://www.showroom-live.com/r/' + live.roomUrlKey);
});
} else {
console.log('No JKT48 members are currently streaming.');
}
} else {
console.error('Error:', data.error);
}
})
.catch(error => console.error('Fetch Error:', error));How It Works
1. API Key Authentication
- Each request must include a valid API key for authentication.
- Contact the administrator for obtaining an API key.
2. Showroom Data Retrieval
- The API checks for currently active JKT48 live streams on Showroom.
- Only JKT48 members and official accounts are included in the results.
- Information is retrieved from the Showroom API and processed in real-time.
3. Response Construction
- The API responds with a JSON object containing:
- successBoolean value indicating the request status.
- timestampThe time when the data was retrieved.
- countThe number of active live streams found.
- livesAn array of objects containing details about each live stream.
4. Data Refresh Rate
- The API refreshes data approximately every 30 seconds.
- Each request provides the most recent available data.
Contact
For inquiries, support, or to request an API key, please reach out via:
- Email: contact@jkt48connect.my.id
- Website: https://jkt48connect.my.id
API Information
- Provider: JKT48 Connect
- Version: 3.0.14(on npmjs)
- License: API for non-commercial use only
- Rate Limit: 60 requests per minute