Skip to main content
MADIAD Hub exposes read-only reporting for the profiles and posts you own. Every endpoint is scoped to your account — profile metrics are keyed by your own profile_id, and post metrics require a request_id from one of your earlier publishes. These are GET requests and do not consume your upload or FFmpeg quota.

​
Profile analytics

Cross-platform follower, reach, and engagement metrics for a single profile. 
curl "https://api.madiad.com/v1/analytics/profile?profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z&platforms=instagram,tiktok,youtube" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramRequiredDescription
profile_idyesThe profile to report on.
platformsyesComma-separated platforms, e.g. instagram,tiktok,linkedin.
facebook_page_idnoReport on a specific Facebook Page.
linkedin_page_urnnoReport on a LinkedIn organization page (defaults to the connected member).
The response wraps the per-platform metric payload under analytics: 
{
  "profile_id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
  "analytics": {
    "instagram": { "followers": 12840, "reach": 90213, "engagement": 0.047 },
    "tiktok":    { "followers": 5320, "views": 412900 }
  }
}

​
Total impressions

Aggregated impressions for one profile over a date range or a named period. 
curl "https://api.madiad.com/v1/analytics/impressions?profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z&period=last_month&breakdown=true" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramRequiredDescription
profile_idyesThe profile to report on.
periodnoOne of last_day, last_week, last_month, last_3months, last_year.
start_date, end_datenoYYYY-MM-DD range (use instead of period).
datenoA single YYYY-MM-DD day.
platformnoRestrict to one platform.
breakdownnotrue to include a per-platform / per-day breakdown.
metricsnoComma-separated metrics, e.g. reach,views,likes,comments.

​
Per-post analytics

Performance for a single post, identified by the request_id returned when you published it. 
curl "https://api.madiad.com/v1/analytics/post?request_id=req_01HZX9H6S8T0V2W4X6Y8Z0A2B4" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
The request_id must belong to one of your own posts. Any other id returns 404 not_found.

​
Publish history

A paginated, newest-first list of everything you’ve published through MADIAD Hub. 
curl "https://api.madiad.com/v1/posts/history?page=1&limit=20" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramRequiredDescription
pageno1-based page number (default 1).
limitnoItems per page, 1–100 (default 20).
profile_idnoFilter to a single profile.
{
  "page": 1,
  "limit": 20,
  "total": 134,
  "items": [
    {
      "id": "evt_01HZX9J8T0V2W4X6Y8Z0A2B4C6",
      "profile_id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
      "type": "video",
      "platforms": ["tiktok", "instagram"],
      "request_id": "req_01HZX9H6S8T0V2W4X6Y8Z0A2B4",
      "created_at": "2026-06-15T08:30:00Z"
    }
  ]
}
Use the request_id from a history item to fetch its per-post analytics or check its status.