Skip to main content

Get Douyin user published videos and first video details with JustOneAPI

Workflow preview

Workflow preview
100%
Get Douyin user published videos and first video details with JustOneAPI preview
Open on n8n.io

1. Workflow Overview

Use this n8n workflow to get published videos from a Douyin user and fetch details for the first video with JustOneAPI. Who’s it for This template is for creator research teams, marketing teams, cr...

Best for

  • Market Research automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

n8n-nodes-base.stickynote, n8n-nodes-base.manualtrigger, n8n-nodes-base.set, n8n-nodes-base.httprequest, n8n-nodes-base.code

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by apisub001.

Original n8n.io source

1.1 Workflow description

Title
Get Douyin user published videos and first video details with JustOneAPI
Workflow name
Get Douyin user published videos and first video details with JustOneAPI

Use this n8n workflow to get published videos from a Douyin user and fetch details for the first video with JustOneAPI.

Who’s it for

This template is for creator research teams, marketing teams, creator operations teams, analysts, and automation builders who want to inspect a Douyin account’s published videos and collect the first video’s detail data in a reusable n8n workflow.

What this workflow does

The workflow starts from a Douyin secUid and sends a request to the User Published Videos V3 endpoint. It keeps the raw video list response, extracts video IDs from data.aweme_list, selects the first unique aweme_id by default, then requests video details with the Video Details V2 endpoint.

The workflow returns both the selected video from the list and the detailed video data in a structured format, while also keeping raw outputs for inspection and troubleshooting.

This makes it useful for account monitoring, video research, content archiving, creator analysis, and building downstream reporting workflows.

What you need

  • A JustOneAPI token
  • A Douyin user secUid
  • An n8n environment with HTTP Request node support

Set up

  1. Import the workflow into n8n.
  2. Open the Prepare API and User Data node.
  3. Add your JustOneAPI token.
  4. Enter the Douyin user secUid.
  5. Leave maxCursor as 0 for the first request, or set it if you want to continue from a previous page.
  6. Leave maxVideos as 1 if you want to fetch details for only the first unique video by default.
  7. Run the workflow and review the final output node.

How it works

  1. Prepare the API base URL, token, user secUid, pagination cursor, and video limit.
  2. Request the user’s published video list from Douyin User Published Videos V3.
  3. Keep the raw video list response for debugging.
  4. Extract videos from data.aweme_list.
  5. Select the first unique video ID from aweme_id.
  6. Request the selected video’s details from Douyin Video Details V2.
  7. Build a final output with structured video list data, selected video data, video detail data, pagination data, and raw API responses.

Output

The final output can include fields such as:

  • requestedSecUid
  • requestedMaxCursor
  • videoRank
  • selectedBy
  • videoId
  • videoDetail
  • selectedVideoFromList
  • videoListSummary
  • pagination
  • rawVideoListOutput
  • rawVideoDetailOutput

The structured video detail output can include fields such as:

  • videoId
  • desc
  • previewTitle
  • createTime
  • groupId
  • secItemId
  • shareUrl
  • shareTitle
  • shareDescription
  • mediaType
  • awemeType
  • isMultiContent
  • imageCount
  • coverImage
  • originCoverImage
  • videoWidth
  • videoHeight
  • videoDuration
  • playUrl
  • downloadUrl
  • authorUid
  • authorSecUid
  • authorNickname
  • authorSignature
  • authorUniqueId
  • musicId
  • musicTitle
  • musicAuthor
  • musicPlayUrl
  • diggCount
  • commentCount
  • shareCount
  • collectCount
  • playCount
  • allowComment
  • allowShare
  • allowDownload

Notes

  • This workflow is built around the Douyin User Published Videos V3 and Video Details V2 endpoints.
  • It selects the first unique aweme_id from data.aweme_list by default.
  • It keeps both raw API responses so you can inspect the original returned data.
  • You can increase maxVideos if you want to extend the workflow to process more than one video.
  • You can connect the final output to Google Sheets, Airtable, Notion, databases, alerts, dashboards, or other n8n workflows.

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 2 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 3 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 4 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 5 - Sticky Note4

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 6 - Sticky Note5

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 7 - Sticky Note6

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 8 - Start Workflow Execution

Type / Role
n8n-nodes-base.manualTrigger - manualTrigger
Config choices
Version 1

Block 9 - Prepare API and User Data

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 10 - Fetch User Published Videos

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 11 - Output Raw Video Data

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 12 - Extract Video IDs from Data

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 13 - Output Extracted Video IDs

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 14 - Fetch First Video Details

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 15 - Build Video Details Output

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 16 - Output Final Video Data

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

3. Summary Table

Workflow Get Douyin user published videos and first video details with JustOneAPI
Complexity advanced
Nodes 16
Categories Market Research
Author apisub001
Published 21 May 2026

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/15882/15882.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Get Douyin user published videos and first video details with JustOneAPI do?

Use this n8n workflow to get published videos from a Douyin user and fetch details for the first video with JustOneAPI. Who’s it for This template is for creator research teams, marketing teams, cr...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Market Research use case.