Your users will often want to share more than just a single image or video. Post for Me makes publishing carousels and multi-image posts incredibly straightforward across all supported platforms.
Here is a breakdown of how to seamlessly handle multiple media assets in a single post request.
The Core Concept
A carousel is a single social media post that contains multiple media assets, allowing users to swipe or click through a gallery of content.
How it works
To publish a carousel, you do not need to use a special endpoint or distinct parameter. You simply pass multiple media objects into the media array when making a POST request to the /v1/social-posts endpoint.
Provide a valid
urlfor each asset within themediaarray.The API will automatically package these assets into the native carousel format for each targeted platform.
The User Experience
The end-user will see a native multi-image or multi-video post on their timeline. They can swipe or click through the content exactly as if it were posted directly from the platform's native app.
Platform and Account Overrides
You maintain full flexibility over your media, even when targeting multiple networks simultaneously.
How it works
If you want to post a multi-image carousel to Instagram but only a single image to Facebook, you can utilize the platform_configurations or account_configurations objects.
Simply pass a new
mediaarray containing your specific objects inside the respective platform's configuration payload.This override will replace the base post's media entirely for that specific network or account, ensuring the most specific content is used.
Requirements
While the Post for Me API accepts multiple media items effortlessly, it is important to remember that each social network enforces its own native limitations. If a platform (such as X) does not natively support the number of media items you have provided in your array, the post attempt for that specific network will fail.