Skip to main content

​
Endpoint

POST https://api.ugc.inc/post

​
Overview

Retrieve a list of posts (videos and slideshows) with optional filtering by account IDs and date range. Use this endpoint to monitor and track all posts across your accounts.

​
Request Body

​
accountIds
string[]
Array of account IDs to filter posts by. Omit to get all posts.
​
postIds
string[]
Array of specific post IDs to retrieve. Use this to fetch specific posts by their IDs.
​
startDate
string
Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z)
​
endDate
string
End date in ISO 8601 format (e.g., 2024-12-31T23:59:59Z)

​
Response

​
data
Post[]
Array of post objects
curl -X POST https://api.ugc.inc/post \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["acc_123456"],
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-12-31T23:59:59Z"
  }'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "post_abc123",
      "account_id": "acc_123456",
      "type": "video",
      "status": "complete",
      "social_id": "7234567890123456789",
      "caption": "Check out this awesome video! 🎥 #viral",
      "media_urls": [
        "https://storage.example.com/video1.mp4"
      ],
      "music_post_id": "music_xyz789",
      "scheduled_at": "2024-01-15T14:30:00Z",
      "postUrl": "https://www.tiktok.com/@username/video/7234567890123456789"
    },
    {
      "id": "post_def456",
      "account_id": "acc_123456",
      "type": "slideshow",
      "status": "scheduled",
      "social_id": null,
      "caption": "Amazing photos from today 📸",
      "media_urls": [
        "https://storage.example.com/img1.jpg",
        "https://storage.example.com/img2.jpg",
        "https://storage.example.com/img3.jpg"
      ],
      "music_post_id": "music_abc123",
      "scheduled_at": "2024-01-20T10:00:00Z"
    }
  ]
}