Live Analytics
Fetch real-time analytics pulled directly from each platform's API, aggregate upload-based impression counts, and retrieve per-post status snapshots.
All endpoints in this section require an API key. Session cookies are not accepted.
Authorization: Apikey YOUR_API_KEY
Live engagement metrics (likes, comments, shares, impressions) are fetched on-demand from each connected platform's API. If a platform connection is missing or its token has expired, that platform's entry will contain an error field. Per-post engagement metrics (/post/:request_id) are not yet stored locally — the endpoint returns post IDs and publish status only.
Get Live Platform Analytics
GET https://api.indreelforge.com/api/analytics/live/:profile_username
Fetches real-time statistics directly from each requested platform's API for the given profile. Supported platforms: instagram, youtube, tiktok, threads, pinterest, bluesky. Other platforms return a message indicating analytics are not yet implemented.
Path Parameters
| Parameter | Description |
|---|---|
profile_username | The name of the profile to fetch analytics for |
Query Parameters
| Parameter | Required | Description |
|---|---|---|
platforms | Yes | Comma-separated list of platforms to query (e.g. instagram,youtube,tiktok) |
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/analytics/live/my-brand?platforms=instagram,youtube,tiktok'
Response
{
"profile": "my-brand",
"platforms": {
"instagram": {
"platform": "instagram",
"followers": 12400,
"media_count": 87,
"username": "mybrand",
"insights": [
{ "name": "reach", "period": "day", "values": [ { "value": 3200, "end_time": "2026-04-18T07:00:00+0000" } ] },
{ "name": "impressions", "period": "day", "values": [ { "value": 8100, "end_time": "2026-04-18T07:00:00+0000" } ] }
]
},
"youtube": {
"platform": "youtube",
"subscribers": 48200,
"views": 1820000,
"video_count": 142,
"channel_name": "My Brand Official"
},
"tiktok": {
"platform": "tiktok",
"followers": 9300,
"following": 120,
"likes": 241000,
"videos": 64
}
}
}
If a platform is not connected or the token is missing, that platform's entry will be:
{ "error": "Not connected" }
If a platform does not yet have a live analytics integration:
{ "platform": "reddit", "message": "Analytics API not yet implemented for this platform" }
Returns 400 if the platforms query parameter is omitted.
Get Total Impressions
GET https://api.indreelforge.com/api/analytics/total-impressions/:profile_username
Returns upload counts broken down by platform for the given profile and time range. This endpoint serves as a proxy for impressions until per-platform analytics APIs are fully wired — the response explicitly flags this.
Path Parameters
| Parameter | Description |
|---|---|
profile_username | The name of the profile |
Query Parameters
| Parameter | Default | Description |
|---|---|---|
period | last_month | Preset range: last_day, last_week / week, last_month / month, 3months, year |
start_date | — | ISO 8601 date string. Overrides period start if provided (e.g. 2026-01-01) |
end_date | — | ISO 8601 date string. Overrides period end if provided |
platform | — | Filter to a single platform (e.g. instagram) |
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/analytics/total-impressions/my-brand?period=last_month&platform=instagram'
Response
{
"profile": "my-brand",
"period": "last_month",
"start_date": "2026-03-19T00:00:00.000Z",
"end_date": "2026-04-18T00:00:00.000Z",
"total_uploads": 47,
"breakdown": {
"instagram": { "count": 32 },
"tiktok": { "count": 14 },
"youtube": { "count": 1 }
},
"note": "Per-platform impression counts are not yet available. This endpoint returns upload counts only."
}
| Field | Description |
|---|---|
total_uploads | Number of completed uploads to this profile in the date range |
breakdown | Per-platform upload counts. Each key is a platform name; count is the upload count |
note | Transparency notice: this endpoint measures uploads, not true impressions |
Returns 404 if the profile does not exist or does not belong to the authenticated user.
Get Post Analytics
GET https://api.indreelforge.com/api/analytics/post/:request_id
Returns publish status and platform post IDs for a specific upload, identified by its request_id or numeric upload ID. Use the returned post_id values to query each platform's native API for engagement metrics.
Path Parameters
| Parameter | Description |
|---|---|
request_id | The request_id returned when the upload was created, or the numeric upload id |
Query Parameters
| Parameter | Description |
|---|---|
platform | Optional. Filter the response to a single platform (e.g. instagram) |
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/analytics/post/req_abc123'
Filter to one platform:
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/analytics/post/req_abc123?platform=instagram'
Response
{
"upload_id": "upl_abc123",
"request_id": "req_abc123",
"title": "Summer campaign reel",
"upload_type": "video",
"created_at": "2026-04-10T14:32:00.000Z",
"completed_at": "2026-04-10T14:34:12.000Z",
"platforms": {
"instagram": {
"post_id": "17846368219001234",
"status": "completed",
"metrics": null
},
"tiktok": {
"post_id": "7012345678901234567",
"status": "completed",
"metrics": null
}
},
"note": "Per-post engagement metrics are not yet available via this endpoint."
}
| Field | Description |
|---|---|
upload_id | Internal upload identifier |
request_id | The request_id passed at upload time |
title | Upload title |
upload_type | Content type (video, photos, text, etc.) |
created_at | ISO 8601 timestamp when the upload was created |
completed_at | ISO 8601 timestamp when publishing finished, or null |
platforms | Map of platform name → { post_id, status, metrics }. metrics is always null until per-platform analytics APIs are wired |
note | Transparency notice about metrics availability |
Returns 404 if the upload does not exist or does not belong to the authenticated user.