TikTok

Access user data, post videos, and manage content via the TikTok API.

Detail	Value
Category	Social Media
Base URL	https://open.tiktokapis.com/v2
Authentication	OAuth2
Endpoints	5
Connector key	tiktok

Using TikTok in a workflow

1. Go to Connections and click New Connection.
2. Pick TikTok from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

Endpoint	Summary
GET /user/info/	Get user info
POST /video/list/	List user videos
POST /video/query/	Get video details by IDs
POST /post/publish/video/init/	Initialize a video upload
POST /post/publish/status/fetch/	Check publish status

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /user/info/

Get user info

Detail	Value
Operation ID	social.getUserInfo
Method	GET
Path	/user/info/

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your TikTok connection from the Connection dropdown.
3. In the Operation dropdown, select social.getUserInfo.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream TikTok API reference.

POST /video/list/

List user videos

Detail	Value
Operation ID	social.listVideos
Method	POST
Path	/video/list/

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your TikTok connection from the Connection dropdown.
3. In the Operation dropdown, select social.listVideos.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream TikTok API reference.

POST /video/query/

Get video details by IDs

Detail	Value
Operation ID	social.queryVideos
Method	POST
Path	/video/query/

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your TikTok connection from the Connection dropdown.
3. In the Operation dropdown, select social.queryVideos.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream TikTok API reference.

POST /post/publish/video/init/

Initialize a video upload

Detail	Value
Operation ID	social.initVideoUpload
Method	POST
Path	/post/publish/video/init/

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your TikTok connection from the Connection dropdown.
3. In the Operation dropdown, select social.initVideoUpload.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream TikTok API reference.

POST /post/publish/status/fetch/

Check publish status

Detail	Value
Operation ID	social.getPublishStatus
Method	POST
Path	/post/publish/status/fetch/

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your TikTok connection from the Connection dropdown.
3. In the Operation dropdown, select social.getPublishStatus.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream TikTok API reference.