API phân tíchAPI

Đọc số liệu của mọi mạng từ một endpoint

FoPost thu thập dữ liệu hiệu suất từ từng tài khoản đã kết nối và trả về theo một cấu trúc nhất quán. Lấy tổng quan không gian làm việc, đi sâu vào một bài đăng, hoặc theo dõi một tài khoản theo thời gian, rồi đưa vào bất kỳ công cụ báo cáo nào bạn dùng.

Lấy khóa APIĐọc tài liệu
GET /v1/analytics/overview
curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

Số liệu chuẩn hóa

Lượt hiển thị, tương tác và người theo dõi dùng cùng tên trường trên mọi mạng.

Ba cấp độ

Tổng quan không gian làm việc, một bài đăng hoặc một tài khoản.

Phạm vi chỉ đọc

Khóa chỉ có phạm vi analytics thì chỉ đọc được số liệu, không gì khác.

Tổng quan

Một lệnh gọi cho báo cáo hàng tháng

Endpoint overview tổng hợp một không gian làm việc trong một khoảng thời gian. Tổng lượt hiển thị, lượt tương tác, thay đổi người theo dõi và số bài đã đăng, nên bản tóm tắt hàng tuần hay báo cáo cho khách hàng chỉ cần một yêu cầu và một mẫu.

Đọc tài liệu tham khảo về phân tích
Các tài khoản đã kết nối trên mọi mạng trong một không gian làm việc

Khoảng thời gian

Truyền days để lấy khoảng gần nhất, tối đa 365 ngày. Mức chênh lệch so sánh với khoảng trước đó.

Lọc theo tài khoản

Thu hẹp tổng quan về một tài khoản khi khách hàng hỏi về một kênh.

Theo từng không gian làm việc

Khóa của agency tính theo không gian làm việc của từng khách hàng, nên báo cáo không bao giờ lẫn sang nhau.

Theo bài đăng

Tìm ra bài đăng nào mang lại hiệu quả

Mọi bài đăng bạn tạo qua API đều giữ id của nó, và id đó đọc lại số liệu từ từng mạng nơi bài xuất hiện. Kết hợp với dữ liệu chiến dịch của riêng bạn, hoặc xếp hạng các bài trong tháng để biết nên lặp lại gì.

Xem số liệu theo bài đăng
GET /v1/posts/:id/analytics
curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

Chi tiết theo tài khoản

Một bài đăng, mỗi mạng một dòng, để bạn thấy kênh nào đã kéo hiệu quả.

Lượt nhấp và permalink

Lượt nhấp liên kết và permalink trực tiếp đi kèm cùng các con số.

Nhóm theo nhãn

Liệt kê bài đăng theo nhãn trước, rồi đọc số liệu cho cả nhóm.

Theo tài khoản

Theo dõi mức tăng trưởng của từng kênh theo thời gian

Endpoint tài khoản trả về chuỗi ảnh chụp số người theo dõi, phạm vi tiếp cận và lượt xem hồ sơ. Đưa vào biểu đồ của riêng bạn, cảnh báo khi số liệu giảm, hoặc cho khách hàng thấy đường tăng trưởng bên cạnh những bài đăng đã tạo ra nó.

Bắt đầu xây dựng
GET /v1/accounts/:id/analytics
curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

Chuỗi ảnh chụp số liệu

Mỗi lần thu thập một điểm dữ liệu cho người theo dõi, phạm vi tiếp cận và lượt xem hồ sơ.

Tự xây cảnh báo

Truy vấn theo lịch và thông báo khi một kênh biến động ngoài mức bình thường.

Làm chủ lịch sử dữ liệu

Lưu chuỗi dữ liệu vào kho dữ liệu của bạn và giữ bao lâu tùy thích.

Giải đáp câu hỏi về API phân tích

Các con số lấy từ đâu?

FoPost đọc số liệu phân tích gốc của từng mạng bằng thông tin xác thực của tài khoản đã kết nối, rồi chuẩn hóa tên trường. Các con số khớp với những gì mạng đó báo cáo trong bảng điều khiển gốc.

Dữ liệu mới đến mức nào?

Số liệu được làm mới theo lịch cho mọi tài khoản đã kết nối. Bài đăng hôm nay sẽ có số liệu ban đầu trong vài giờ và ổn định dần khi mạng chốt các con số.

Mọi mạng có báo cáo cùng số liệu không?

Bộ số liệu cốt lõi gồm lượt hiển thị, lượt tương tác và người theo dõi là chung. Số liệu mà một mạng không cung cấp được trả về là null thay vì 0, để bạn phân biệt được thiếu dữ liệu với giá trị trống.

Tôi có lấy được số liệu của bài đăng ngoài API không?

Có. Mọi bài đăng qua tài khoản đã kết nối đều được theo dõi ở cấp tài khoản, và bài tạo trong bảng điều khiển cũng có id như mọi bài khác.

Tôi cần phạm vi nào?

Phạm vi analytics. Khóa chỉ có phạm vi này là chỉ đọc, không thể đăng, sửa hay quản lý tài khoản.

Có giới hạn tần suất không?

Có, 100 yêu cầu mỗi phút cho mỗi khóa. Hãy đọc theo lô với khoảng thời gian thay vì gọi một lần cho mỗi ngày.

Xây dựng trên API phân tích ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API