Search Douyin videos by keyword and get the first video detail with JustOneAPI

Description

Use this n8n workflow to search Douyin videos by keyword and get the first video detail with JustOneAPI.

Who’s it for

This template is for creator research teams, content operations teams, marketing teams, analysts, and automation builders who want to search Douyin video content and collect the first matched video detail in a reusable format.

What this workflow does

The workflow starts from a Douyin search keyword and sends a request to the Douyin Video Search V4 endpoint. It keeps the raw search response, extracts the first available video ID from the returned search results, then sends a second request to the Douyin Video Details V2 endpoint.

The workflow keeps both raw API responses for inspection and troubleshooting, and also converts the selected video detail into a cleaner structured output for downstream use.

This makes it useful for content discovery, video research, creator analysis, campaign monitoring, competitor research, content archiving, and automated reporting workflows.

What you need

A JustOneAPI token
A Douyin search keyword
An n8n environment with HTTP Request node support

Set up

Import the workflow into n8n.
Open the Prepare / Config node.
Add your JustOneAPI token.
Enter the Douyin video search keyword.
Adjust optional search filters such as sort type, publish time, duration, page, or search ID if needed.
Run the workflow.

How it works

Prepare the API inputs in one configuration node.
Search Douyin videos through the Video Search V4 endpoint.
Keep the raw search response for inspection and troubleshooting.
Extract the first available aweme_id from the real search response.
Request the selected video detail through the Video Details V2 endpoint.
Keep the raw detail response for debugging and verification.
Return cleaned main video detail data together with auxiliary search data.

Output

The final output can include fields such as:

videoId
description
title
caption
createTime
shareUrl
author
statistics
coverImage
playUrls
downloadUrls
duration
music
hashtags
challenges
videoTags
status
videoControl
selectedSearchResult
candidateVideos
searchSummary
rawSearchResponse
rawDetailResponse

Notes

This workflow is built around the Douyin Video Search V4 and Video Details V2 endpoints.
It only fetches the detail of the first available video from the search results.
It preserves raw search and detail responses so you can inspect the original API data.
You can connect the final output to Google Sheets, Airtable, Notion, databases, alerts, dashboards, or other n8n workflows.