List TikTok posts

What it does

Request

GET /ad-accounts/{acc}/tiktok-posts on https://api.apogee.ad/api/v1.

Path parameters

• acc string path required

  TikTok advertiser id (GET /ad-accounts?platform=tiktok)

  Matches ^\d{1,32}$

Query parameters

• source string query optional

  One of account, authorized

• identity_id string query optional

  Matches ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

• identity_type string query optional

  One of TT_USER, BC_AUTH_TT

• bc_id string query optional

  Matches ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

• cursor string query optional

  next_cursor of the previous page

• page string query optional

  Matches ^\d{1,3}$

Headers

• Authorization string header required

  Bearer apk_…: an API key with the scope of this route.

Response

200.

• source string

  One of account, authorized

• posts array of objects
  Fields of each item (11)

  • item_id string or null
  • spark_post object

    What goes in a launch plan's ads[].spark_post

  • caption string or null
  • visibility string or null
  • account object
    Fields (3)

    • id string or null
    • type string or null
    • name string or null
  • duration_sec number or null
  • preview_url string or null
  • authorization object

    A creator's post: its authorization (status, end, days left)

  • usable boolean

    false: TikTok would refuse it now (refusals)

  • refusals array of strings
  • warnings array of strings
• available boolean
• account object
  Fields (3)

  • id string or null
  • type string or null
  • name string or null
• next_cursor string or null

  source account: the next page

• page number or null
• total_pages number or null

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Example

With your key in APOGEE_API_KEY (create one):

curl 'https://api.apogee.ad/api/v1/ad-accounts/7000000000000000001/tiktok-posts' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "source": "account",
  "available": false,
  "account": {
    "id": "120200000000000001",
    "type": "120200000000000001",
    "name": "Nordlicht | Spring launch"
  },
  "posts": [
    {
      "item_id": "120200000000000001",
      "caption": "Example text",
      "visibility": "120200000000000001",
      "account": {
        "id": "120200000000000001",
        "type": "120200000000000001",
        "name": "Nordlicht | Spring launch"
      },
      "duration_sec": 1,
      "preview_url": "https://www.example.com/products/nordlicht-jacket",
      "authorization": {},
      "usable": false,
      "refusals": [
        "120200000000000001"
      ],
      "warnings": [
        "120200000000000001"
      ],
      "spark_post": {}
    }
  ],
  "next_cursor": null,
  "page": 1,
  "total_pages": 1
}

Access and cost

In the MCP

An AI assistant does the same with this tool of the MCP server:

• list_tiktok_posts: TikTok Spark Ads: the existing posts a launch can run as ads, keeping their likes and comments. source: "account" (default): the video posts of one of the brand's TikTok accounts (the first one, or identity_id from the launch interview), a page at a time; source: "authorized": the posts creators authorized for this ad account. Each post says whether it can run and gives its spark_post for prepare_launch.

Related operations

• Create import: POST /imports
• Get import: GET /imports/{id}
• List drive folder: GET /drive-folders
• Create uploads: POST /uploads
• Confirm uploads: POST /uploads/confirm
• List TikTok music: GET /ad-accounts/{acc}/tiktok-music
• List platform templates: GET /ad-accounts/{acc}/platform-templates