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
Copied!
const { SuperfaceClient } = require('@superfaceai/one-sdk');
// You can manage tokens here: https://superface.ai/insights
const sdk = new SuperfaceClient({ sdkAuthToken: '<< Login to get your token >>' });
async function run() {
// Load the profile
const profile = await sdk.getProfile('social-media/publish-post@2.0.1');
// Use the profile
const result = await profile
.getUseCase('PublishPost')
.perform({
profileId: '110658944785122',
text: 'Text of the Post.'
}, {
provider: 'mock'
});
// Handle the result
try {
const data = result.unwrap();
console.log(data);
} catch (error) {
console.error(error);
}
}
run();Copied!
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
{
"profileId": "110658944785122",
"text": "Text of the Post."
}Copied!
Result (object)
postId
optional
Identifier of the published post.
string
url
optional
Link to the published post.
string
Example
{
"postId": "110658944785122_125682506616099",
"url": "https://www.facebook.com/110658944785122/posts/125682506616099/"
}Copied!