GET/social-media/my-social-accounts
Retrieves a list of social media accounts connected to the workspace associated with the API key. Each account includes its latest daily follower or subscriber count.
pf-api-keyRate limit: 350 requests per hourWhat DISABLED means
When connectionStatus is DISABLED, publishing to that account is paused until it is reconnected (re-authorized) in the PostFast app. Reconnecting resumes future scheduled posts automatically.
Posts already scheduled to an account that becomes disabled are held, not deleted. If the account is reconnected before the scheduled time they publish normally; if the scheduled time passes while the account is still disabled they are marked FAILED and can be retried.
Connection status is tracked per connection, so the same social account connected to multiple workspaces is tracked independently for each.
Follower counts
Each connected account's follower or subscriber count is captured once per UTC day (around 04:00 UTC) and returned as followerCount (a bigint-safe numeric string) plus followerCountUpdatedAt (the UTC day it was captured for). Read it daily to build your own growth history.
followerCount is null until the first daily capture after an account is connected, and for platforms not yet supported (X, Google Business Profile).
A temporary platform outage can skip a day; the previous value stays available, and followerCountUpdatedAt tells you how fresh it is.
For day-by-day history and the net change over a range, call /social-media/{socialMediaId}/follower-history instead of storing your own daily snapshots.
Recent posts imported on connect
When an account is first connected or reconnected, PostFast imports the posts published on it in the last 60 days (including posts not created through PostFast) so they show up in GET /social-posts with analytics. The import runs in the background and skips posts already in your account, so it never creates duplicates.
Supported on Facebook Pages, Instagram, Threads, and TikTok. Metrics fill in shortly after the import (TikTok can take 24-48 hours). TikTok media is not retained, so imported TikTok posts have no stored thumbnail.
Follower count by platform
| Platform | Counts | Notes |
|---|---|---|
| Followers | Business/Creator accounts | |
| Page followers | Per connected Page | |
| YouTube | Subscribers | Approximate (YouTube rounds public counts); hidden-subscriber channels return null |
| Threads | Followers | |
| Followers | ||
| Bluesky | Followers | |
| Telegram | Channel/group members | The PostFast bot must remain in the chat |
| Page followers | Organization Pages only; personal profiles return null | |
| TikTok | Followers | |
| X (Twitter) | Not yet available | |
| Google Business Profile | Not yet available |
Response
200 OK Array of connected social media accounts.
idstringrequiredUnique identifier for the account. Account IDs are immutable and safe to cache.
platformstringrequiredSocial network the account belongs to, one of the 11 supported platforms: X, FACEBOOK, INSTAGRAM, THREADS, LINKEDIN, TIKTOK, YOUTUBE, BLUESKY, PINTEREST, TELEGRAM, GOOGLE_BUSINESS_PROFILE.
platformUsernamestringoptionalUsername on the platform.
displayNamestringoptionalDisplay name of the account.
connectionStatusstringrequiredCONNECTED means publishing works; DISABLED means publishing is paused until the account is reconnected.
CONNECTEDDISABLEDdisabledReasonstringoptionalWhy publishing is paused. Present only when connectionStatus is DISABLED. In practice only TOKEN_REVOKED and ACCOUNT_SUSPENDED are currently produced; PERMISSION_REVOKED and MANUAL are reserved.
TOKEN_REVOKEDACCOUNT_SUSPENDEDPERMISSION_REVOKEDMANUALfollowerCountstring | nulloptionalLatest captured follower/subscriber count, as a numeric string (bigint-safe). null until the first daily capture, or for platforms not yet supported.
followerCountUpdatedAtISO 8601 | nulloptionalUTC day the count was captured for (e.g. 2026-06-11T00:00:00.000Z). null if no count has been captured.