You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.
Publish Social Media Post
social-media/publish-post@2.0.15 providers
Publish a Post
Publish a post on a social media profile with optional image or video attachments.
Input
Profile ID
Text
Link
Title
Media attachments
Video IDs
Result
Post ID
Post URL
1.Choose a provider
2.Use PublishPost with mock in your code
Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk
Structure details
Input (object)
profileId
optional
Identifier of a profile to publish to. May be optional with some providers.
string
text
optional
Text of the post
string
link
optional
URL to attach to the post
string
title
optional
Title of the post, if supported by the provider (e.g. Pinterest). Ignored otherwise.
string
media
optional
Only images and gifs are supported
list
url
optional
Will be fetched by provider, must be accessible publicly.
If both `contents` and `url` fields are provided, a preferable option will be picked by the map.
string
contents
optional
If both `contents` and `url` fields are provided, a preferable option will be picked by the map.
altText
optional
Alternative text for screen readers
string
videos
optional
IDs of previously uploaded videos (see `social-media/upload-from-url`) to be attached or published.
list
Example
Result (object)
postId
optional
Identifier of the published post.
string
url
optional
Link to the published post.
string