Platformdaki gönderiler ve metrikleri
GET https://app.apsilo.com/api/public/v1/social/mediaApsilo’dan veya doğrudan platformdan paylaşılmış gönderiler ve güncel metrikleri.
Gerekli kapsam: social_analytics:read
Parametreler
| Parametre | Yer | Tip | Gereklilik | Açıklama |
|---|---|---|---|---|
platform | sorgu | instagram · facebook · x · tiktok | isteğe bağlı | Platform |
format | sorgu | string | isteğe bağlı | Biçim |
from | sorgu | string | isteğe bağlı | Başlangıç |
to | sorgu | string | isteğe bağlı | Bitiş |
source | sorgu | all · apsilo · external | isteğe bağlı | Kaynak (varsayılan all) |
sort | sorgu | string | isteğe bağlı | Sıralama alanı (varsayılan published_at; metrik anahtarı da olabilir) |
order | sorgu | asc · desc | isteğe bağlı | Sıralama yönü (varsayılan desc) |
limit | sorgu | integer | isteğe bağlı | Sayfa boyutu |
cursor | sorgu | string | isteğe bağlı | Önceki yanıtın nextCursor değeri (opak) |
X-Request-Id | başlık | string | isteğe bağlı | İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, ._:-); yanıtta aynen döner ve kayıtlara işlenir. |
Yanıtlar
| Durum | Açıklama |
|---|---|
200 | Gönderiler |
401 | Kimlik doğrulanamadı. Olası kodlar: API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED. |
403 | Erişim reddedildi. Olası kodlar: FEATURE_NOT_LICENSED, API_SCOPE_MISSING, IP_NOT_ALLOWED, LICENSE_EXPIRED, LICENSE_NOT_FOUND, FORBIDDEN. |
422 | İşlenemeyen istek. Olası kodlar: VALIDATION_FAILED, MESSAGING_WINDOW_CLOSED, CHANNEL_ACCOUNT_MISSING, CONTACT_BLOCKED, STORAGE_LIMIT_REACHED, SOCIAL_POST_INVALID, SOCIAL_PLATFORM_UNAVAILABLE. |
429 | Hız sınırı aşıldı. Olası kodlar: RATE_LIMITED. |
500 | Sunucu hatası. Olası kodlar: INTERNAL. |
Yanıt gövdesi
| Alan | Tip | Gereklilik | Açıklama |
|---|---|---|---|
data | SocialMediaItem[] | zorunlu | |
nextCursor | string,null | zorunlu | Sonraki sayfa için cursor değeri; son sayfada null. |