Get social posts

GEThttps://admin.snagsolutions.io/api/loyalty/posts

Fetch social posts with pagination and filtering options. Note: Rank is calculated for top 20,000 posts only. Posts beyond this threshold will have a null rank.

Loading code example

Loading code example

Query Parameters

websiteIdstring<uuid>

UUID of the website to fetch social posts for

organizationIdstring<uuid>

UUID of the organization to fetch social posts for

userGroupIdstring<uuid>

Optional UUID of the user group to filter posts

userIdany

Optional UUID of the user to filter posts

loyaltyPostIdany

Optional UUID of the loyalty post to filter posts

cursorstring

Cursor for pagination

limitintegerdefault: 20

Number of posts to fetch per page

Required range: x >= 1, x <= 100

Default: 20

sortBy"rank" | "createdAt"default: rank

Sort posts by createdAt or rank

Allowed values: "rank" | "createdAt"

Default: "rank"

Response

application/json

200

dataarray<object>required

data.idstring<uuid>required

data.textstring

data.mediaUrlstring

data.previewUrlstring

data.externalIdentifierstring

data.latestRewardnumber

data.loyaltyCurrencyIdstring<uuid>required

data.userMetadataobjectrequired

data.mediaType"image" | "video"required

Allowed values: "image" | "video"

data.platform"twitter" | "tiktok"required

Allowed values: "twitter" | "tiktok"

data.postType"post" | "comment" | "repost"required

Allowed values: "post" | "comment" | "repost"

data.parentPostIdstring<uuid>

data.likeCountnumber

data.commentCountnumber

data.repostCountnumber

data.viewCountnumber

data.manualRanknumber

data.dynamicScorenumber

data.ranknumber

data.loyaltyRuleIdstring<uuid>required

data.contentQualityScorenumber

data.sentimentScoreinteger

Required range: x >= 1, x <= 100

data.postedAtstring<date-time>

data.isSeenbooleanrequired

data.authorIdstringrequired

data.userIdstring<uuid>required

data.createdAtstring<date-time>required

data.updatedAtstring<date-time>required

hasNextPagebooleanrequired

GET /api/loyalty/posts — query parameters: websiteId, organizationId, userGroupId, userId, loyaltyPostId, cursor, limit, sortBy