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
| Parametre | Tip | Açıklama |
|---|---|---|
workspaceId | string | Belirli bir workspace’e göre filtrele |
connected | boolean | true yalnızca bağlı, false yalnızca bağlantısı kopuk |
platform | string | Platform filtresi (instagram facebook vb.) |
Kod Örnekleri
Node.js
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
| Parametre | Açıklama |
|---|---|
id | Hesap ID’si (acc_...) |
Kod Örnekleri
Node.js
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ğer | Platform |
|---|---|
instagram | |
facebook | |
linkedin | |
tiktok | TikTok |
twitter | Twitter / X |
youtube | YouTube |
Last updated on