Endpoint
POST https://api.ugc.inc/post/status
Overview
Check the current status of a specific post. Use this endpoint to monitor whether a post has been successfully published or if there were any issues.
Post Status Values
scheduled - Post is scheduled to be published at a future timepending - Post is currently being processed/publishedcomplete - Post was successfully published to the platformfailed - Post failed to publish (check error logs for details)
Request Body
Post ID to check status for
Response
Status information for the post
ID of the post being checked
Current status of the post
Direct URL to the post on the social media platform. Only available when status is complete.
- TikTok:
https://www.tiktok.com/@username/video/{social_id}
- Instagram:
https://www.instagram.com/p/{social_id}/
curl -X POST https://api.ugc.inc/post/status \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"postId": "post_abc123"
}'
{
"ok": true,
"code": 200,
"message": "Success",
"data": {
"post_id": "post_abc123",
"status": "complete",
"postUrl": "https://www.tiktok.com/@username/video/7234567890123456789"
}
}
