TikTok Scheduled — List

Overview

Lists all posts currently queued for scheduled publishing to TikTok on this account — across every status (pending, processing, posted, failed, canceled). Sorted by scheduled_for ascending.

Posts are created by passing scheduled_for to the TikTok publish endpoint instead of publishing immediately.

Endpoint

GET https://eranol.com/api/v1/social/tiktok/scheduled-posts

Response fields

Field	Type	Notes
id	string	The scheduled post's id — pass this to the cancel endpoint
platform	string	Always "tiktok" for this endpoint
payload	object	The original publish request body for this post
scheduled_for	string	ISO timestamp of when the post is/was due to publish
status	string	pending, processing, posted, failed, or canceled
fail_reason	string | null	Present when status is failed
result	object | null	Present when status is posted — the platform-specific publish result
created_at	string	ISO timestamp of when the post was scheduled

Example response

{
  "scheduled_posts": [{
        "id": "a1b2c3d4-...",
        "platform": "tiktok",
        "payload": {
            "video_url": "https://www.eranol.com/uploads/video.mp4",
            "title": "Check this out! #fyp",
            "privacy_level": "PUBLIC_TO_EVERYONE"
        },
        "scheduled_for": "2026-09-01T15:00:00.000Z",
        "status": "pending",
        "fail_reason": null,
        "result": null,
        "created_at": "2026-08-25T10:00:00.000Z"
    }]
}

Errors

Status	Meaning
401	Missing or invalid API key
402	Insufficient credits
500	Internal server error — try again or contact support