Analytics APIAPI

Her ağın metriklerini tek uç noktadan okuyun

FoPost, her bağlı hesabın performans verilerini toplar ve tutarlı tek bir yapıda geri sunar. Çalışma alanı özetini çekin, bir gönderinin ayrıntısına inin veya bir hesabı zaman içinde izleyin; ardından verileri raporlama aracınıza aktarın.

API Anahtarını Al Belgeleri Okuyun

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 }]
}

Normalleştirilmiş metrikler

Gösterim, etkileşim ve takipçi her ağda aynı alan adlarını kullanır.

Üç seviye

Çalışma alanı özeti, tek gönderi veya tek hesap.

Salt okunur kapsam

Yalnızca analytics kapsamına sahip bir anahtar rakamları okuyabilir, başka hiçbir şey yapamaz.

Özet

Aylık rapor için tek çağrı

Özet uç noktası, bir çalışma alanını belirli bir tarih aralığında toplar. Gösterim, etkileşim, takipçi değişimi ve yayınlanan gönderi toplamları sayesinde haftalık özet veya müşteri raporu tek istek ve bir şablondan ibarettir.

Analitik Referansını Okuyun

Tek bir çalışma alanında tüm ağlardaki bağlı hesaplar

Tarih aralıkları

En fazla 365 günlük geriye dönük bir pencere için gün sayısı gönderin. Değişimler bir önceki pencereyle karşılaştırılır.

Hesaba göre filtreleyin

Bir müşteri tek bir kanalı sorduğunda özeti tek bir hesaba daraltın.

Çalışma alanı başına

Ajans anahtarları müşteri çalışma alanı başınadır, bu yüzden raporlar asla birbirine karışmaz.

Gönderi başına

İşi hangi gönderinin yaptığını öğrenin

API üzerinden oluşturduğunuz her gönderi kimliğini korur ve bu kimlik, ulaştığı her ağdan metrikleri okur. Kendi kampanya verilerinizle birleştirin veya ayın gönderilerini sıralayıp neyi tekrarlayacağınızı görün.

Gönderi Başına Metrikleri Görün

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"
}

Hesap bazında döküm

Tek gönderi, ağ başına bir satır; böylece onu hangi kanalın taşıdığını görürsünüz.

Tıklamalar ve kalıcı bağlantılar

Bağlantı tıklamaları ve canlı kalıcı bağlantı, sayılarla birlikte gelir.

Etikete göre gruplayın

Önce gönderileri etikete göre listeleyin, ardından o kümenin metriklerini okuyun.

Hesap başına

Her kanaldaki büyümeyi zaman içinde izleyin

Hesap uç noktası; takipçi sayısı, erişim ve profil görüntülemeleri için bir anlık görüntü serisi döndürür. Kendi grafiklerinize aktarın, bir düşüşte uyarı alın veya bir müşteriye yükselen çizgiyi, onu hareketlendiren gönderilerle yan yana gösterin.

Geliştirmeye Başlayın

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" }
  ]
}

Anlık görüntü serisi

Takipçi, erişim ve profil görüntülemeleri için her toplama çalışmasında bir veri noktası.

Kendi uyarılarınızı oluşturun

Belirli aralıklarla sorgulayın ve bir kanal normal aralığının dışına çıktığında bildirim alın.

Geçmişe sahip olun

Seriyi veri ambarınızda saklayın ve istediğiniz kadar tutun.

Analytics API hakkında sorular ve yanıtlar

Rakamlar nereden geliyor?

FoPost, bağlı hesabın kimlik bilgilerini kullanarak her ağın kendi analitik verilerini okur, ardından alan adlarını normalleştirir. Rakamlar, ağın kendi panelinde bildirdikleriyle eşleşir.

Veriler ne kadar güncel?

Metrikler her bağlı hesap için düzenli aralıklarla yenilenir. Bugün yayınlanan bir gönderi birkaç saat içinde ilk rakamları gösterir ve ağ sayılarını kesinleştirdikçe oturur.

Tüm ağlar aynı metrikleri bildiriyor mu?

Gösterim, etkileşim ve takipçiden oluşan temel set ortaktır. Bir ağın sunmadığı metrikler sıfır yerine null olarak döner; böylece olmayan veriyi boş veriden ayırt edebilirsiniz.

API dışında yayınlanan gönderilerin metriklerini alabilir miyim?

Evet. Bağlı hesap üzerinden yayınlanan her gönderi hesap düzeyinde izlenir ve panelde oluşturulan gönderilerin de diğerleri gibi kimlikleri vardır.

Hangi kapsama ihtiyacım var?

analytics kapsamına. Yalnızca bu kapsama sahip bir anahtar salt okunurdur; yayınlayamaz, düzenleyemez veya hesap yönetemez.

İstek sınırı var mı?

Evet, anahtar başına dakikada 100 istek. Her gün için ayrı çağrı yapmak yerine okumaları tarih aralıklarıyla toplu yapın.

Analytics API ile bugün geliştirmeye başlayın

Başlamak ücretsizdir ve eksiksiz API dahildir. Bir anahtar oluşturun ve ilk çağrınızı dakikalar içinde yapın.

API Anahtarını Al