POpostproxy
Profiles

Get profile

Retrieves a single profile by its ID. The response includes the profile fields plus the latest stats snapshot per placement and (for placement networks) a summary_stats rollup.

get/api/profiles/{id}

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Profile id

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Response

The profile with latest stats

idstring

Unique profile identifier (id).

namestring

Display name of the connected account.

usernamestring nullable

Handle on the platform (without @). null when the platform does not expose one.

platform_idstring

The account's ID on the platform.

status'active' | 'expired' | 'inactive'

Platform connection status. inactive might mean disconnected or suspended on a platform, or waiting for a group that can take it - see inactive_reason.

inactive_reason'network_taken' | 'null' nullable

Why an inactive profile is inactive. network_taken: the account arrived with a Facebook login that granted several Instagram accounts, but its group already holds an active Instagram profile - move it to a group without one to activate it. null otherwise, including when the connection was lost and needs reconnecting.

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'youtube' | 'twitter' | 'threads' | 'pinterest' | 'bluesky' | 'telegram' | 'google_business'

Platform identifier.

profile_group_idstring

ID of the profile group this belongs to.

expires_atstring nullable

ISO 8601 timestamp when the connection expires (if applicable). null when the token does not expire or has a refresh token.

post_countinteger

Number of posts made through this profile.

avatar_urlstring nullable

Stable Postproxy storage URL of the account's profile picture, resized to 256x256. null until it has been mirrored. For facebook this is the connecting user's picture; each Page's picture is avatar_url on its placement.

platform_urlstring nullable

Public URL of the account on the platform. null when the platform has no stable public profile URL (e.g. linkedin, google_business).

placements_sync_status'syncing' | 'synced' | 'failed' | 'null' nullable

State of the latest pull of this profile's placements. The pull runs in the background right after connecting and can take several minutes on profiles with many pages/locations. null for platforms without placements and for telegram, whose channels arrive via webhook.

Changes

No recorded changes to this operation across all 1 revision of this API.