Get Post Broadcast

Retrieve the live stream broadcast data for a post. Returns video URL, featured image, and live status from Firestore.

Endpoint

GET /api/posts/:id/broadcast

Authentication

Required. Must be a member of the post's group (or a platform admin).

Path Parameters

Parameter	Type	Description
id	integer	The post ID

Response

Success Response — Broadcast Found

Status Code: 200 OK

{
  "found": true,
  "video": "https://firebasestorage.googleapis.com/.../video.mp4",
  "featuredImage": "https://storage.googleapis.com/.../frame.jpg",
  "isLive": false,
  "livestreamState": "ended",
  "watcherCount": 12
}

Field	Type	Description
found	boolean	Whether a broadcast exists for this post
video	string	Video URL (null if not yet recorded)
featuredImage	string	Thumbnail image URL
isLive	boolean	Whether the stream is currently live
livestreamState	string	Stream state (e.g. "ended", "live")
watcherCount	integer	Number of current viewers

Success Response — No Broadcast

Status Code: 200 OK

{
  "found": false
}

Error Responses

Status Code	Description
400	Invalid post ID
403	Not a member of the group
404	Post not found

Example

curl -X GET "https://api.tribesocial.io/api/posts/4212/broadcast" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"