Social Media Posts
social-media/posts@1.0.14 providers
Get Profile's Posts
Retrieve a paginated list of posts from a social media profile.
Input
Profile ID
Before date
After date
Page
Result
Previous page
Next page
Posts
1.Choose a provider
2.Use GetProfilePosts 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/posts@1.0.1');
// Use the profile
const result = await profile
.getUseCase('GetProfilePosts')
.perform({
profileId: '',
beforeDate: '',
afterDate: '',
page: ''
}, {
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 retrieve posts from. May be optional with some providers.
string
beforeDate
optional
Filter posts that have been created before the date in ISO 8601 date and time format.
string
afterDate
optional
Filter posts that have been created after the date in ISO 8601 date and time format.
string
page
optional
Pagination cursor (obtained from `previousPage` or `nextPage`).
string
Example
{
"profileId": "",
"beforeDate": "",
"afterDate": "",
"page": ""
}Copied!
Result (object)
previousPage
optional
Previous page cursor.
string
nextPage
optional
Next page cursor.
string
posts
optional
List of posts ordered by creation date. Latest posts are on the top of the list.
list
id
optional
Identifier of the post.
string
url
optional
Permanent URL to the post.
string
createdAt
optional
Date and time the post was published at.
string
text
optional
Text of the post.
string
attachments
optional
List of attachments.
list
type
optional
Attachment type (e.g. image, video).
string
url
optional
Attachment URL.
string
preview
optional
Thumbnail or another preview of the attachment.
title
optional
Attachment title.
string
description
optional
Attachment description.
string
altText
optional
Alternative text of the attachment.
string
duration
optional
Duration of the attached video.
number
width
optional
Widht of the attached image.
number
height
optional
Height of the attached image.
number
Example
{
"previousPage": "",
"nextPage": "",
"posts": [
{
"id": "",
"url": "",
"createdAt": "",
"text": "",
"attachments": [
{
"type": "",
"url": "",
"preview": "",
"title": "",
"description": "",
"altText": "",
"duration": 42,
"width": 42,
"height": 42
}
]
}
]
}Copied!