📱 Mobile API Documentation

Comprehensive API for Faithful Radio mobile apps and integrations

API Information

Base URL: https://faithful-radio.com/api/mobile/

Version: 1.0.0

Rate Limit: 100 requests per hour per IP

Response Format: JSON

Authentication: None required (public API)

Available Endpoints

/api/mobile/status

GET
Get current radio status, listener count, and stream information.

Example Response:

{ "success": true, "timestamp": 1729984800, "api_version": "1.0.0", "data": { "online": true, "listeners": 15, "server_status": "online", "stream_url": "http://radio.voscast.com:8646/stream", "website_url": "https://faithful-radio.com", "uptime": { "seconds": 2678400, "human": "31d 0h 0m" }, "quality": "128kbps MP3", "genre": "Christian/Worship" } }

Try It Out:

/api/mobile/stats

GET
Get comprehensive listener statistics and analytics data.

Example Response:

{ "success": true, "data": { "current_listeners": 15, "peak_listeners_today": 42, "total_listener_hours": 1250, "average_listening_time": 45, "listener_history": [...], "server_uptime": {...}, "total_songs_played": 3420, "most_popular_songs": [...] } }

/api/mobile/chat

GET POST
Get chat messages or send new messages to the live chat.
GET Parameters (Optional)
since (timestamp)
Get messages since this timestamp (default: last hour)
limit (integer)
Maximum number of messages to return (max: 50, default: 20)
POST Body (JSON)
message (string, required)
Chat message content (1-500 characters)
nickname (string, required)
User nickname (2-20 characters, alphanumeric, underscore, dash)

/api/mobile/requests

GET POST
View song requests or submit new song requests.
POST Body (JSON)
song_title (string, required)
Title of the requested song
artist (string, required)
Artist name
requester_name (string, optional)
Name of the person making the request (default: "Anonymous")
message (string, optional)
Optional message with the request
priority (string, optional)
Request priority: "low", "normal", "high" (default: "normal")

/api/mobile/nowplaying

GET
Get information about the currently playing song and recently played tracks.

/api/mobile/schedule

GET
Get programming schedule and upcoming events.

/api/mobile/playlists

GET
Get information about available playlists.

/api/mobile/feedback

POST
Submit feedback, ratings, or bug reports.
POST Body (JSON)
type (string, required)
Feedback type: "song_rating", "app_feedback", "bug_report", etc.
content (string, optional)
Feedback content or message
rating (integer, optional)
Numeric rating (1-5 stars, etc.)

Example POST Body:

{ "type": "song_rating", "content": "Great song! Love this one.", "rating": 5 }