Skip to Content

Hesaplar

Kullanıcının workspacelerindeki bağlı sosyal medya hesaplarını sorgulayın. Her hesap için takipçi sayısı, son senkronizasyon zamanı ve en güncel metrikler elde edilebilir.


Hesapları Listele

GET/v1/accounts

Kullanıcının tüm workspacelerindeki bağlı sosyal medya hesaplarını döner.

Query Parametreleri

ParametreTipAçıklama
workspaceIdstringBelirli bir workspace’e göre filtrele
connectedbooleantrue yalnızca bağlı, false yalnızca bağlantısı kopuk
platformstringPlatform filtresi (instagram facebook vb.)

Kod Örnekleri

hesaplari-listele.js
const params = new URLSearchParams({ connected: 'true' }) const response = await fetch( `https://api.sosyalkopru.com/v1/accounts?${params}`, { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } } ) const { data } = await response.json() console.log(`${data.length} aktif hesap`) data.forEach(h => { console.log(`[${h.platform.toUpperCase()}] ${h.displayName} — ${h.id}`) })

Başarılı Yanıt

{ "success": true, "data": [ { "id": "acc_01HZGK9P3QABC", "workspaceId": "ws_01HZGK9P3QABC", "platform": "instagram", "username": "@sosyalkopru", "displayName": "Sosyal Köprü", "profilePictureUrl": "https://cdn.sosyalkopru.com/avatars/abc.jpg", "isConnected": true, "connectedAt": "2025-01-15T10:00:00.000Z" }, { "id": "acc_01HZGK9P3QDEF", "workspaceId": "ws_01HZGK9P3QABC", "platform": "linkedin", "username": "sosyal-kopru", "displayName": "Sosyal Köprü", "profilePictureUrl": null, "isConnected": true, "connectedAt": "2025-02-01T09:00:00.000Z" } ], "meta": { "requestId": "req_01HZGK9P3QRSTU", "timestamp": "2025-06-10T12:00:00.000Z", "version": "1" } }

Hesap Detayı

GET/v1/accounts/{id}

Tek bir hesabın takipçi sayısı, son senkronizasyon bilgisi ve en güncel metrikleriyle birlikte detaylı bilgilerini döner.

Path Parametresi

ParametreAçıklama
idHesap ID’si (acc_...)

Kod Örnekleri

hesap-detay.js
const accountId = 'acc_01HZGK9P3QABC' const response = await fetch( `https://api.sosyalkopru.com/v1/accounts/${accountId}`, { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } } ) if (response.status === 404) { console.error('Hesap bulunamadı veya erişim yetkiniz yok') process.exit(1) } const { data } = await response.json() console.log(`${data.platform}: @${data.username}`) console.log(`Takipçi: ${data.followerCount?.toLocaleString('tr-TR') ?? 'bilinmiyor'}`) console.log(`Son senkronizasyon: ${data.lastSyncAt}`) if (data.latestMetrics) { const m = data.latestMetrics console.log(`\nSon dönem metrikleri:`) console.log(` Gösterim : ${m.impressions?.toLocaleString('tr-TR') ?? '-'}`) console.log(` Erişim : ${m.reach?.toLocaleString('tr-TR') ?? '-'}`) console.log(` Etkileşim: %${m.engagementRate?.toFixed(2) ?? '-'}`) } if (data.stats) { console.log(`\nToplam istatistikler:`) console.log(` Tüm zamanlar: ${data.stats.totalPosts} gönderi`) console.log(` Son 30 gün : ${data.stats.postsLast30Days} gönderi`) }

Başarılı Yanıt

{ "success": true, "data": { "id": "acc_01HZGK9P3QABC", "workspaceId": "ws_01HZGK9P3QABC", "platform": "instagram", "username": "@sosyalkopru", "displayName": "Sosyal Köprü", "profilePictureUrl": "https://cdn.sosyalkopru.com/avatars/abc.jpg", "followerCount": 12480, "isConnected": true, "lastSyncAt": "2025-06-10T06:00:00.000Z", "connectedAt": "2025-01-15T10:00:00.000Z", "latestMetrics": { "impressions": 42300, "reach": 35800, "engagementRate": 5.24, "likes": 2180, "comments": 312, "recordedAt": "2025-06-09T00:00:00.000Z" }, "stats": { "totalPosts": 184, "postsLast30Days": 12, "avgEngagementRate": 5.61 } }, "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" } }

Desteklenen Platformlar

DeğerPlatform
instagramInstagram
facebookFacebook
linkedinLinkedIn
tiktokTikTok
twitterTwitter / X
youtubeYouTube
Last updated on