사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/apidojo-io/apidojo-skills --skill scraping-youtube-trending-videos시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Scraping Youtube Trending Videos
Raw data collection. No assumed use case — returns the full dataset for downstream analysis.
Inputs
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
type | string | Optional | n | Trending category: n (now), music, movies, gaming |
gl | string | Optional | us | Country code (e.g. US, GB) |
hl | string | Optional | en | Language code (e.g. en) |
maxItems | number | Optional | Unlimited | Maximum videos to return |
customMapFunction | string | Optional | — | JavaScript function to transform each output object |
How to Run
Using run_actor.js (recommended)
bash
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'
# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.csv --format csv
# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.json --format jsonREST API fallback
bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-trending-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'If Apify MCP is available: Use the Apify MCP call_actor tool with actor apidojo~youtube-trending-scraper and the input above.
Output Fields
| Field | Type | Description |
|---|---|---|
type | string | Always video |
id | string | Video ID |
title | string | Video title |
url | string | Video URL |
description | string | Video description |
duration | number | Duration in seconds |
views | number | View count |
likes | number | Like count |
status | string | Availability status |
channel.id | string | Channel ID |
channel.name | string | Channel name |
channel.url | string | Channel URL |
keywords | array | Video tags/keywords |
isLive | boolean | Live stream flag |
thumbnails | array | Thumbnail objects |
Edge Cases
- No results for category: Some countries may not have all category pages. Fall back to type=
n. - Empty results: YouTube may show different trending per session — retry.
- Region mismatch: gl and hl must be valid ISO codes.
- Data freshness: Trending changes frequently — data reflects a point-in-time snapshot.
