Social Profiles
Read the social profiles (Facebook Pages, Instagram, LinkedIn, …) connected to your account.
List connected social profiles
Returns all social media profiles currently connected to your account. A social profile represents an authenticated connection to an external platform such as Facebook, Instagram, LinkedIn, Google, or TikTok. Profiles are established through the platform's OAuth flow in the web dashboard and cannot be connected via this API. Each entry in the response includes the platform name, username, profile name, profile picture URL, connection date, a disconnected flag indicating whether the connection has become invalid, and a count of linked pages or sub-accounts. To get full details for a specific platform, including all linked pages and sub-accounts, call GET /socials/{platform} with the platform name (e.g. facebook, instagram, linkedin, google, tiktok). If a profile shows disconnected=true, the OAuth token has expired or been revoked and the connection must be re-established through the web dashboard. Returns 401 if the API key is missing or invalid. Returns 502 if the upstream profile service is temporarily unavailable.
Get social profile detail
Returns the full details for a specific connected social platform, including all linked pages or sub-accounts (e.g. Facebook Pages managed by the connected Facebook profile). The platform path parameter is case-insensitive and must be one of: facebook, instagram, linkedin, google, tiktok. The response includes top-level profile information (username, profile name, picture, website, biography, link count, connection date, disconnected status) as well as a pages array. Each page entry contains the page ID, page name, profile picture, username, website, biography, link count, connection and expiration dates, and a disconnected flag. Use this endpoint when you need to enumerate all pages or sub-accounts available under a platform connection, for example to select which Facebook Page to publish content to. Returns 404 if no connected profile exists for the given platform name. This could mean the platform was never connected or has been removed. Returns 401 if the API key is missing or invalid. Returns 502 if the upstream profile service is temporarily unavailable.