GET/social-posts/analytics

Fetch published posts with their latest performance metrics. Only returns posts that have been successfully published (with a platformPostId).

https://api.postfa.st/Auth: pf-api-keyRate limit: 350 requests per hour

Notes

Only returns posts with status PUBLISHED and a valid platformPostId.

LinkedIn personal accounts are excluded (no metrics available from the LinkedIn API).

All metric values are returned as strings (bigint), e.g. "1234" not 1234. Parse them to numbers in your code.

latestMetric is null until metrics have been fetched for that post.

No pagination, so keep date ranges reasonable to avoid large responses.

extras holds platform-specific metrics not in the standard fields.

Results are automatically filtered to the workspace tied to the API key.

Pinterest extras

Pinterest pins populate the standard impressions, likes (reactions), and comments fields, plus these keys inside extras:

Lifetime: pin_clicks (clicks opening the pin close-up) and outbound_clicks (clicks to the destination URL).

Rolling 90-day window (Pinterest only exposes these over 90 days): impressions_90d, pin_clicks_90d, and outbound_clicks_90d.

Video pins additionally include lowercased Pinterest video metric keys, such as video_mrc_view, video_10s_view, and video_avg_watch_time.

Requires a Pinterest Business account on the connected social media. Personal accounts can be upgraded to Business for free via Pinterest settings.

Query parameters

startDateISO 8601required

Start of the date range, e.g. 2026-01-01T00:00:00.000Z.

endDateISO 8601required

End of the date range, e.g. 2026-01-31T23:59:59.999Z.

platformsstringoptional

Comma-separated platform values to filter by, e.g. FACEBOOK,INSTAGRAM.

socialMediaIdsstringoptional

Comma-separated UUIDs to filter by specific social media account ids (from /social-media/my-social-accounts).

Response

200 OK An object with a data array of published posts and their latest metrics.

dataarrayoptional

Published posts in the date range.

idstring (UUID)optional

Post id.

contentstringoptional

Text content of the post.

socialMediaIdstring (UUID)optional

Account the post was published to.

platformPostIdstringoptional

Id of the post on the platform.

publishedAtISO 8601optional

When the post was published.

latestMetricobject | nulloptional

Latest fetched metrics, or null until metrics have been fetched.

likesstring (bigint)optional

Likes, e.g. 1234.

commentsstring (bigint)optional

Comments.

sharesstring (bigint)optional

Shares.

impressionsstring (bigint)optional

Impressions.

reachstring (bigint)optional

Reach. May be null on platforms that don't report it (e.g. Pinterest).

totalInteractionsstring (bigint)optional

Total interactions for the post.

extrasobjectoptional

Platform-specific metrics not in the standard fields (varies by platform).

fetchedAtISO 8601optional

When the metrics were fetched.