YouTube Trending Feed Extractor by Category & Market: MCP config, n8n workflow and API

{
  "mode": "charts",
  "charts": [
    "trendingVideos"
  ],
  "categories": [
    "gaming"
  ],
  "newsSections": [
    "top"
  ],
  "countries": [
    "US"
  ],
  "period": "daily",
  "maxItems": 3,
  "maxItemsPerChart": 3,
  "includeVideoDetails": false,
  "maxConcurrency": 3,
  "onlyNew": false,
  "monitorName": "default"
}

---
name: youtube-trending-feed-extractor-by-category
description: "Ranked YouTube chart entries and category-hub videos with rank movement, exact video details and status rows. Runs the Apify Actor nimbryxo-studio/youtube-trending-feed-extractor-by-category. Use when the user needs YouTube data with fields such as position, sourceName, title, channelName, chartViewCount, viewCount and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/youtube-trending-feed-extractor-by-category"
  store-url: "https://apify.com/nimbryxo-studio/youtube-trending-feed-extractor-by-category"
---

# YouTube Trending Feed Extractor by Category & Market

Use this skill to fetch YouTube data with the Apify Actor `nimbryxo-studio/youtube-trending-feed-extractor-by-category` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `charts`, `hubs`, required | What to read. 'charts' uses YouTube's official music, trailer and podcast charts. 'hubs' uses YouTube's category pages such as Gaming trending, News, Sports, Learning and Courses. |
| `charts` | array | One or more YouTube charts. Trending music videos is the official replacement for the retired general Trending page. Top songs and top artists are weekly; Shorts songs is daily or weekly. Music and Shorts charts include rank movement and optional history. |
| `categories` | array | One or more category pages. Gaming trending and Gaming live return up to 50 videos. News reads the selected news sections. Sports, Learning and Courses are editorial category feeds. |
| `newsSections` | array | Which News tabs to read. 'Top stories' is the main /news page; the other sections are direct news-destination feeds. Available sections vary by country. |
| `countries` | array | One or more markets. The 68 YouTube Charts markets are supported; 'global' is supported only for charts that publish a global ranking (top videos, top songs, top artists, Shorts songs). |
| `period` | one of `daily`, `weekly` | Daily or weekly ranking. Weekly-only charts automatically use weekly. Current-only charts such as Trending music videos and Trending movie trailers ignore this setting. |
| `date` | string | Historical chart date in YYYY-MM-DD format. Leave empty for the latest chart. Supported by Top music videos, Top songs, Top artists and Shorts songs; current-only charts ignore it. |
| `maxItems` | integer | Total data rows to return across all charts, categories and countries. |
| `maxItemsPerChart` | integer | Rows to take from each chart/country or category/country combination. Source ceilings still apply. |
| `includeVideoDetails` | boolean | Fetch exact lifetime views, likes, upload dates and descriptions for every video. YouTube category, tags, Shorts eligibility and family-safe flags are filled when YouTube's player response is available and may be omitted on some cloud IPs. |
| `maxConcurrency` | integer | How many exact-detail requests may run in parallel. |
| `onlyNew` | boolean | Skip rows already emitted by a previous run with the same monitor name. |
| `monitorName` | string | Separate only-new histories by monitor name. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "charts",
  "charts": [
    "trendingVideos"
  ],
  "categories": [
    "gaming"
  ],
  "newsSections": [
    "top"
  ],
  "countries": [
    "US"
  ],
  "period": "daily",
  "maxItems": 3,
  "maxItemsPerChart": 3,
  "includeVideoDetails": false,
  "maxConcurrency": 3,
  "onlyNew": false,
  "monitorName": "default"
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~youtube-trending-feed-extractor-by-category/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~youtube-trending-feed-extractor-by-category/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `position`, `sourceName`, `title`, `channelName`, `chartViewCount`, `viewCount`, `countryCode`, `chartType`, `type`, `url`, `status`, `recordType`, `videoId`, `trackId`, `artistId`, `playlistId`, `channelId`, `channelUrl`, `channelHandle`, `channelAvatarUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.