Postproxy API Overview
Postproxy is a unified API for posting content to social media platforms with built-in scheduling, error handling, and retry management. It also covers engagement — reading and replying to comments on your posts, and reading and sending 1:1 direct messages.
Core concepts
Section titled “Core concepts”Profile
Section titled “Profile”A connected social media account (X, Facebook, Instagram, etc.) that you can post content to. Each profile represents an authenticated connection to a specific platform.
A piece of content published through one or more profiles. Can include text, media (images or videos), or both. Platform-specific parameters let you customize how content appears on each platform.
Profile Group
Section titled “Profile Group”A collection of profiles grouped together for organizational purposes. Use profile groups to separate brands, clients, or projects. API keys can be scoped to specific profile groups for access control.
Comment
Section titled “Comment”A comment on one of your published posts — either synced from the platform or created through the API. You can list, reply to, hide, and like comments. See the Comments API.
Chat & Message
Section titled “Chat & Message”A chat is a 1:1 direct-message conversation between one of your profiles and a participant; it holds inbound and outbound messages. Supported on Facebook Messenger, Instagram, Telegram, and Bluesky. See the Direct Messages API.
Supported platforms
Section titled “Supported platforms”| Platform | Content Types |
|---|---|
| Posts, Reels, Stories | |
| Posts, Reels, Stories | |
| TikTok | Videos |
| Posts | |
| YouTube | Videos |
| X (Twitter) | Posts |
| Threads | Posts |
| Pins | |
| Bluesky | Posts |
| Telegram | Posts (channels via bring-your-own-bot) |
| Google Business | Local posts, events, offers, and review replies |
Media handling
Section titled “Media handling”When creating a post with media, provide URLs to your images or videos. Postproxy downloads and processes the media, then uploads it to each platform according to their requirements.
Each platform has specific constraints for media (file size, formats, dimensions). See Platform Parameters for details.
Rate limits and retries
Section titled “Rate limits and retries”Social networks have rate limits that Postproxy handles automatically. If a post hits a rate limit, Postproxy queues it and retries when possible. You don’t need to implement retry logic in your application.