skills.rest
inclusionAI
inclusionAIOFFICIAL
Explore all skills by this author →
WebsiteGitHub

tikhub-youtube-search

Queries TikHub YouTube search and video-detail APIs and post-processes raw JSON into CSV summaries.

1.2k|126|Updated Mar 14, 2025
Search Tags:#api#CSV#Search#Json#video metadata#youTube#tikhub
One-click install
npx skills add https://github.com/inclusionAI/AWorld --skill tikhub-youtube-search
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tikhub-youtube-search
Source: https://github.com/inclusionAI/AWorld/tree/main/aworld-skills/youtube_search
Command: npx skills add https://github.com/inclusionAI/AWorld --skill tikhub-youtube-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx.

What problem does it solve?

Manually querying the TikHub YouTube API and wrangling its large raw JSON responses is repetitive and error-prone. This Skill provides minimal curl and Python request patterns, a raw-JSON-first saving convention, and a stdlib-only post-processor that converts responses into CSV and simplified JSON.

Core Features & Use Cases

  • Single-request workflows: Run one YouTube general search or one video-detail lookup via curl or a tiny httpx snippet, with the full raw response saved for audit and replay.
  • Raw JSON post-processing: The included postprocess_youtube_raw.py script reads one file or a directory of raw responses and writes youtube_search_summary.csv and youtube_search_summary.json.
  • Pagination and batch guidance: Supports continuation-token pagination and low-concurrency batch requests for many keywords or video IDs.
  • Use Case: A researcher needs structured metadata for 50 YouTube videos matching a keyword. They run one search request, save the raw JSON, then run the post-processor to get a clean CSV of titles, authors, view counts, and URLs.

Quick Start

Set the TIKHUB_API_KEY environment variable and ask the agent to search YouTube for a keyword through TikHub and save the raw JSON results.

Frequently Asked Questions about tikhub-youtube-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search YouTube videos using the TikHub API?▼

Send a GET request to the TikHub get_general_search_v2 endpoint with a keyword parameter and an Authorization Bearer header containing your API key. You can use curl directly or a small Python httpx snippet, then save the full raw JSON response.

How do I get YouTube video details like views and likes from an API?▼

Call the TikHub get_video_info endpoint with a video_id, language_code, and need_format=true. Prefer the view_count_text, like_count_text, and date_text fields, since structured numeric fields are sometimes empty in detail responses.

What API key do I need for TikHub YouTube search?▼

You need a TikHub API key supplied through the TIKHUB_API_KEY environment variable or provided directly by the user. The Skill contains no hardcoded key and will stop and ask for one if it is missing.

Why does the TikHub video detail response have empty view counts?▼

Detail responses may populate display fields while leaving structured fields empty. Use view_count_text, like_count_text, and date_text as fallbacks, and ensure need_format is sent as the string true or false rather than a blank parameter.

What are the limitations of TikHub YouTube search?▼

It does not download media streams, crawl comments, extract transcripts, or crawl entire channels beyond what search responses include. Rate limiting can return 429 errors, so batch usage should stay at three to five concurrent workers.

Related Skills

Explore More Data & Analytics Skills→
Tigha66Tigha66

youtube

Search YouTube videos, fetch video and channel details, and retrieve transcripts.

Community
Intermediate
zm2231zm2231

analytics-optimization

Track content performance and integrate GA4, social, and email analytics into unified dashboards.

Community
Advanced
botanicastudiosbotanicastudios

scrapesocial-youtube

Compiles YouTube channel, video, shorts, transcript, and comment data via scrapesocial CLI.

Official
Advanced
jianshuojianshuo
114

wjs-uploading-video

Upload single or batch videos to YouTube via API v3 with metadata.

Community
Advanced