Synchronize external posts
Coming soon — Analytics endpoints are being rolled out and may return empty data until the rollout completes.
Fetches an account's latest posts published directly on its platform. Supplying url or postId searches for a specific post. Requests made within the per-account debounce window return cached results with synced.skipped set to true.
Authorization
bearerAuth PostZen API key.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/posts/sync-external" \ -H "Content-Type: application/json" \ -d '{ "accountId": "j97kp4mw2xnv6r1t8c3zq5bs9fh0yg4d", "url": "https://www.pinterest.com/pin/1234567890/" }'{ "synced": { "postsFound": 0, "postsSynced": 0, "skipped": true }, "found": true, "post": { "platform": "x", "platformPostId": "string", "platformPostUrl": "http://example.com", "content": "string", "publishedAt": "2019-08-24T14:15:22Z", "mediaType": "string", "mediaUrl": "http://example.com", "thumbnailUrl": "http://example.com", "mediaItems": [ { "type": "string", "url": "http://example.com", "thumbnail": "http://example.com" } ], "analytics": { "impressions": 0, "reach": 0, "likes": 0, "comments": 0, "shares": 0, "saves": 0, "clicks": 0, "views": 0, "engagementRate": 0, "lastUpdated": "2019-08-24T14:15:22Z" } }, "posts": [ { "platform": "x", "platformPostId": "string", "platformPostUrl": "http://example.com", "content": "string", "publishedAt": "2019-08-24T14:15:22Z", "mediaType": "string", "mediaUrl": "http://example.com", "thumbnailUrl": "http://example.com", "mediaItems": [ { "type": "string", "url": "http://example.com", "thumbnail": "http://example.com" } ], "analytics": { "impressions": 0, "reach": 0, "likes": 0, "comments": 0, "shares": 0, "saves": 0, "clicks": 0, "views": 0, "engagementRate": 0, "lastUpdated": "2019-08-24T14:15:22Z" } } ]}{ "error": "string", "platform": "x", "platformError": "string"}{ "error": "Unauthorized"}{ "error": "string"}{ "error": "API key requires read_write permission"}{ "error": "Not found"}{ "error": "rate_limited", "retryAfter": 30}{ "error": "Failed to create post"}Get follower statistics GET
> **Coming soon** — Analytics endpoints are being rolled out and may return empty data until the rollout completes. Returns follower history and growth for connected accounts at daily, weekly, or monthly granularity.
List API keys GET
Returns the API keys for the authenticated account. The full key value is never returned; only a masked `keyPreview` is shown. Read-only and read-write API keys are accepted.