Dataify Youtube Video Post

API key required

Use for Dataify YouTube video post collection Builder tasks. Trigger when the user asks for the YouTube video post collection tool, YouTube video collection, YouTube video scraping, YouTube video post scraping, YouTube videos by URL, search filters, hashtag, podcast URL, keyword, or Explore URL, or asks with Chinese wording such as YouTube视频抓取, YouTube视频采集, YouTube视频帖子采集, 通过关键词抓取YouTube视频, 通过URL抓取YouTube视频, 通过标签抓取YouTube视频, or 通过探索抓取YouTube视频. Supports choosing between youtube_video-post_by-url, youtube_video-post_by-search-filters, youtube_video-post_by-hashtag, youtube_video-post_by-podcast-url, youtube_video-post_by-keyword, and youtube_video-post_by-explore; receiving task_id/status; and troubleshooting Dataify Builder requests.

Install

openclaw skills install dataify-youtube-video-post

Dataify YouTube Video Post

Submit YouTube video post collection jobs through Dataify Builder, then stop. This skill is a guided wrapper for six collection modes:

Mode	Collector ID	Use For
URL	`youtube_video-post_by-url`	Collecting video posts from a YouTube channel Videos URL.
Search Filters	`youtube_video-post_by-search-filters`	Searching video posts by keyword plus filters.
Hashtag	`youtube_video-post_by-hashtag`	Collecting video posts by hashtag.
Podcast URL	`youtube_video-post_by-podcast-url`	Collecting video posts from a YouTube podcast or playlist URL.
Keyword	`youtube_video-post_by-keyword`	Collecting video posts by keyword.
Explore	`youtube_video-post_by-explore`	Collecting video posts from a YouTube Explore URL.

After a successful submission, give the user the task_id, the returned or inferred status, and tell them to visit https://dataify.com/dashboard/ to view results.

API TOKEN Handling

Use DATAIFY_API_TOKEN as the long-term saved token name.

If the user provides a token in the request, use it for this run.
If no token is provided, first check whether DATAIFY_API_TOKEN is already saved locally in the environment.
If DATAIFY_API_TOKEN is saved locally, use it.
If no token is available locally, tell the user to get an API TOKEN from Dataify.
Do not call the Builder endpoint without a token.
Always call it API TOKEN in user-facing instructions. Prefer the environment variable name DATAIFY_API_TOKEN for saved local use.

PowerShell examples for saving the token for the current session:

$env:DATAIFY_API_TOKEN = "YOUR_DATAIFY_API_TOKEN"

For a persistent user-level variable on Windows:

[Environment]::SetEnvironmentVariable("DATAIFY_API_TOKEN", "YOUR_DATAIFY_API_TOKEN", "User")

Core Workflow

First ask the user to choose a collection mode. Show the Mode Selection table.
After the user chooses a mode, show only that mode's parameter table and defaults.
For any dropdown-style field in the selected mode, show all allowed options as a Markdown table with Label and Value columns.
Ask whether the user wants to change any value before running the task.
Ask whether the user wants to collect multiple YouTube video post groups for the selected mode.
Normalize the final values into a list of parameter objects for the selected mode only.
Resolve the Dataify token from explicit input or saved DATAIFY_API_TOKEN.
If no token is available, tell the user to get an API TOKEN from Dataify.
Validate the selected mode, parameters, and file name.
Submit the Builder request with the selected mode's spider_id.
Read data.task_id from the Builder response and read data.status or status when present.
Stop after Builder succeeds.
Tell the user to visit https://dataify.com/dashboard/ to view or manage results.

Mode Selection

When the user invokes this skill, first show this Markdown table and ask them to choose one mode:

Label	Value
Collect video posts by channel Videos URL	`url`
Collect video posts by search filters	`search_filters`
Collect video posts by hashtag	`hashtag`
Collect video posts by podcast URL	`podcast_url`
Collect video posts by keyword	`keyword`
Collect video posts by Explore URL	`explore`

Ask: "Which collection mode do you want to use?"

Do not submit a Builder request until the mode is clear.

URL Mode

Use this section only when the user chooses url.

Field	Required	Default	Notes
`url`	Yes	`https://www.youtube.com/@stephcurry/videos`	YouTube channel Videos URL. Must use `https://www.youtube.com`.
`order_by`	No	`最新`	Dropdown-style option.
`start_index`	No	`1`	Integer greater than or equal to `0`.
`num_of_posts`	No	`5`	Integer greater than or equal to `0`.
`file_name`	No	`{{TasksID}}`	Builder form field.

order_by options:

Label	Value
Latest	`最新`
Popular	`热门`
Oldest	`最早`

Submit spider_id=youtube_video-post_by-url with objects like:

[{"url":"https://www.youtube.com/@stephcurry/videos","order_by":"最新","start_index":"1","num_of_posts":"5"}]

For multiple URL groups, provide multiple url, order_by, start_index, and num_of_posts objects.

Search Filters Mode

Use this section only when the user chooses search_filters.

Field	Required	Default	Notes
`keyword_search`	Yes	`popular music`	Keyword used to search YouTube videos.
`features`	No	`All`	Dropdown-style option.
`type`	No	`Videos`	Dropdown-style option.
`duration`	No	`Under 3 minutes`	Dropdown-style option.
`upload_date`	No	`Last hour`	Dropdown-style option.
`num_of_posts`	No	`200`	Integer greater than or equal to `0`.
`file_name`	No	`{{TasksID}}`	Builder form field.

features options:

Label	Value
All	`All`
Live	`Live`
4K	`4K`
HD	`HD`
Subtitles/CC	`Subtitles/CC`
Creative Commons	`Creative Commons`
360°	`360°`
VR180	`VR180`
3D	`3D`
HDR	`HDR`

type options:

Label	Value
Video	`Videos`
Movie	`Movies`

duration options:

Label	Value
4 分钟以内	`4 分钟以内`
4-20 分钟	`4-20 分钟`
20 分钟以上	`20 分钟以上`
全部	`None`

upload_date options:

Label	Value
上一小时	`Last hour`
今天	`Today`
本周	`This week`
本月	`This month`
今年	`This year`
全部	`All`

Submit spider_id=youtube_video-post_by-search-filters with objects like:

[{"keyword_search":"popular music","features":"Subtitles/CC","type":"Videos","duration":"None","upload_date":"Last hour","num_of_posts":"200"}]

For multiple search-filter groups, provide multiple keyword_search, features, type, duration, upload_date, and num_of_posts objects.

Hashtag Mode

Use this section only when the user chooses hashtag.

Field	Required	Default	Notes
`hashtag`	Yes	`shopping`	Topic hashtag used to filter YouTube videos.
`num_of_posts`	No	`10`	Integer greater than or equal to `0`.
`file_name`	No	`{{TasksID}}`	Builder form field.

Submit spider_id=youtube_video-post_by-hashtag with objects like:

[{"hashtag":"shopping","num_of_posts":"10"}]

For multiple hashtag groups, provide multiple hashtag and num_of_posts objects.

Podcast URL Mode

Use this section only when the user chooses podcast_url.

Field	Required	Default	Notes
`url`	Yes	`https://www.youtube.com/playlist?list=RDCLAK5uy_lS3E3PgpboCkZ_PfLPCkLLNPI1uH6kfc0`	YouTube podcast or playlist URL. Must use `https://www.youtube.com`.
`num_of_posts`	No	`10`	Integer greater than or equal to `0`.
`file_name`	No	`{{TasksID}}`	Builder form field.

Submit spider_id=youtube_video-post_by-podcast-url with objects like:

[{"url":"https://www.youtube.com/playlist?list=RDCLAK5uy_lS3E3PgpboCkZ_PfLPCkLLNPI1uH6kfc0","num_of_posts":"10"}]

For multiple podcast URL groups, provide multiple url and num_of_posts objects.

Keyword Mode

Use this section only when the user chooses keyword.

Field	Required	Default	Notes
`keyword`	Yes	`top videos`	Keyword used to search YouTube videos.
`num_of_posts`	No	`10`	Integer greater than or equal to `0`.
`file_name`	No	`{{TasksID}}`	Builder form field.

Submit spider_id=youtube_video-post_by-keyword with objects like:

[{"keyword":"top videos","num_of_posts":"10"}]

For multiple keyword groups, provide multiple keyword and num_of_posts objects.

Explore Mode

Use this section only when the user chooses explore.

Field	Required	Default	Notes
`url`	Yes	`https://www.youtube.com/feed/storefront?bp=ogUCKAU%3D`	YouTube Explore URL. Must use `https://www.youtube.com`.
`all_tabs`	No	`true`	Dropdown-style option. Specifies whether to collect all tabs.
`file_name`	No	`{{TasksID}}`	Builder form field.

all_tabs options:

Label	Value
Collect all tabs	`true`
Do not collect all tabs	`false`

Submit spider_id=youtube_video-post_by-explore with objects like:

[{"url":"https://www.youtube.com/feed/storefront?bp=ogUCKAU%3D","all_tabs":"true"}]

For multiple Explore groups, provide multiple url and all_tabs objects.

Shared Parameter Handling

file_name defaults to {{TasksID}}.
If the user changes file_name, submit the user-provided value.
file_name cannot be empty.
URL-based modes must accept only URLs whose scheme and host are exactly https://www.youtube.com.
Integer fields must be greater than or equal to 0.
Submit numeric and boolean-like values as strings, matching the Builder examples.
Submit spider_parameters as a JSON string containing an array of one or more objects.

Dataify Builder Request

Use form fields rather than hand-built URL-encoded strings.

URL: https://scraperapi.dataify.com/builder?platform=1
Method: POST
Authorization header: Bearer DATAIFY_API_TOKEN
Content type: application/x-www-form-urlencoded
Fixed fields:
- spider_name=youtube.com
- spider_errors=true
Mode-specific spider_id:
- URL mode: youtube_video-post_by-url
- Search Filters mode: youtube_video-post_by-search-filters
- Hashtag mode: youtube_video-post_by-hashtag
- Podcast URL mode: youtube_video-post_by-podcast-url
- Keyword mode: youtube_video-post_by-keyword
- Explore mode: youtube_video-post_by-explore
Default field:
- file_name={{TasksID}}
Dynamic field:
- spider_parameters must be a JSON string, not a raw object.

Script

For stable execution, prefer scripts/submit_dataify_youtube_video_post.py with Python 3.6 or newer instead of rewriting the Builder flow.

python3 ".\scripts\submit_dataify_youtube_video_post.py" --mode keyword --keyword "top videos"

If python3 is not available, use the local Python 3 command for that machine, such as python. The script checks the runtime version and tells the user to use Python 3.6 or newer if the active interpreter is too old.

To submit multiple groups, pass a JSON array for the selected mode:

python3 ".\scripts\submit_dataify_youtube_video_post.py" --mode hashtag --params-json '[{"hashtag":"shopping","num_of_posts":"10"},{"hashtag":"music","num_of_posts":"25"}]'

The script prints a JSON summary with mode, spider_id, task_id, status, parameters, file_name, dashboard_url, and message.

Troubleshooting

Missing Dataify API TOKEN means no explicit token was passed and DATAIFY_API_TOKEN is not saved locally. Tell the user to get an API TOKEN from Dataify.

Unsupported mode means the mode must be url, search_filters, hashtag, podcast_url, keyword, or explore.

URL must use https://www.youtube.com means the URL is non-compliant.

Unsupported order_by, Unsupported all_tabs, or other unsupported dropdown messages mean the value must be one of that field's allowed values.

File name cannot be empty means no usable file_name was provided.

Missing task_id usually means the authorization header, token, spider_name, or selected spider_id is wrong.

Guardrails

Do not mix parameters from different modes in the same Builder request.
Do not invent result fields.
Always direct the user to https://dataify.com/dashboard/ after successful task creation.