Chuyển đến nội dung chính
MADIAD Hub cung cấp báo cáo read-only cho các profile và bài đăng thuộc về bạn. Mọi endpoint đều giới hạn trong phạm vi tài khoản của bạn, số liệu profile được khóa theo profile_id của chính bạn, còn số liệu bài đăng yêu cầu request_id từ một lần đăng trước đó. Đây là các request GET và không tiêu tốn quota upload hay FFmpeg.

​
Analytics theo profile

Số liệu follower, reach và engagement đa nền tảng cho một profile. 
curl "https://api.madiad.com/v1/analytics/profile?profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z&platforms=instagram,tiktok,youtube" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramBắt buộcMô tả
profile_idcóProfile cần báo cáo.
platformscóDanh sách nền tảng phân tách bằng dấu phẩy, ví dụ instagram,tiktok,linkedin.
facebook_page_idkhôngBáo cáo cho một Facebook Page cụ thể.
linkedin_page_urnkhôngBáo cáo cho một trang tổ chức LinkedIn (mặc định là tài khoản đã kết nối).
Response gói payload số liệu theo nền tảng dưới khóa analytics: 
{
  "profile_id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
  "analytics": {
    "instagram": { "followers": 12840, "reach": 90213, "engagement": 0.047 },
    "tiktok":    { "followers": 5320, "views": 412900 }
  }
}

​
Tổng impressions

Tổng hợp impressions cho một profile theo khoảng ngày hoặc theo một period định sẵn. 
curl "https://api.madiad.com/v1/analytics/impressions?profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z&period=last_month&breakdown=true" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramBắt buộcMô tả
profile_idcóProfile cần báo cáo.
periodkhôngMột trong last_day, last_week, last_month, last_3months, last_year.
start_date, end_datekhôngKhoảng YYYY-MM-DD (dùng thay cho period).
datekhôngMột ngày YYYY-MM-DD duy nhất.
platformkhôngGiới hạn về một nền tảng.
breakdownkhôngtrue để kèm breakdown theo nền tảng hoặc theo ngày.
metricskhôngDanh sách metrics phân tách bằng dấu phẩy, ví dụ reach,views,likes,comments.

​
Analytics theo từng bài

Hiệu suất của một bài đăng, xác định bằng request_id trả về khi bạn đăng bài đó. 
curl "https://api.madiad.com/v1/analytics/post?request_id=req_01HZX9H6S8T0V2W4X6Y8Z0A2B4" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
request_id phải thuộc về một bài đăng của chính bạn. Mọi id khác sẽ trả về 404 not_found.

​
Lịch sử đăng bài

Danh sách phân trang, mới nhất trước, của mọi thứ bạn đã đăng qua MADIAD Hub. 
curl "https://api.madiad.com/v1/posts/history?page=1&limit=20" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Query paramBắt buộcMô tả
pagekhôngSố trang tính từ 1 (mặc định 1).
limitkhôngSố mục mỗi trang, 1–100 (mặc định 20).
profile_idkhôngLọc theo một 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"
    }
  ]
}
Dùng request_id từ một mục lịch sử để lấy analytics theo từng bài (mục ở trên) hoặc kiểm tra trạng thái của nó.