# YouTube Shorts Scraper - Channels & Hashtags (`atesen-software/youtube-shorts-scraper`) Actor

Scrape YouTube Shorts from channels and hashtags: title, views, video ID and URL, thumbnail, and optionally exact publish date, likes, comments, description and the creator channel. Latest or popular. No API key, no browser.

- **URL**: https://apify.com/atesen-software/youtube-shorts-scraper.md
- **Developed by:** [Atesen Software](https://apify.com/atesen-software) (community)
- **Categories:** Social media, Videos
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Shorts Scraper - Channels & Hashtags

Scrape **YouTube Shorts** from **channels** and **hashtags**: title, video ID, Shorts URL, **views** and thumbnail, and optionally the **exact publish date, likes, comment count, description, hashtags and the creator's channel and subscribers**. Latest or most popular Shorts of a channel, or the Shorts feed of any hashtag.

- You pay per saved Short (see the Pricing tab). Exact details cost nothing extra; they only make the run slower.
- Channels as `@handle`, URL or channel ID; hashtags as `#cats`, `cats` or hashtag URLs.
- **No API key, no login, no browser**, 256 MB.
- Unknown channels, channels without Shorts and empty hashtags become free status rows.

### Use cases

- **Short-form trend research**: what is going viral under a hashtag right now.
- **Creator analytics**: a channel's Shorts performance (views, likes, comments).
- **Influencer discovery**: find creators behind top Shorts for a topic.
- **Content inspiration and datasets**: titles, descriptions and engagement at scale.

### Input

| Field | Description |
|---|---|
| `channels` | Channel handles, URLs or IDs |
| `hashtags` | `#cats`, `cats`, hashtag URLs |
| `maxShortsPerSource` | Default 50, 0 = all |
| `sortBy` | `latest` or `popular` (channels) |
| `videoDetails` | Exact date, likes, comments, description, creator |

> Keywords, category and exact duration come from YouTube's player data, which YouTube sometimes withholds. When that happens those fields are `null`; publish date, views, likes, comment count, description, hashtags and channel subscribers still come from the watch page (`detailsSource: "watch-page"`).

```json
{
  "channels": ["@MrBeast"],
  "hashtags": ["#cats"],
  "maxShortsPerSource": 100,
  "videoDetails": true
}
```

### Output

```json
{
  "type": "short",
  "videoId": "Y8IJi7iP5vk",
  "title": "Last To Fall Wins",
  "url": "https://www.youtube.com/shorts/Y8IJi7iP5vk",
  "source": "channel",
  "channelName": "MrBeast",
  "viewCount": 78000000,
  "likeCount": 2100000,
  "commentCount": 10038,
  "publishedAt": "2026-10-10T09:00:00-07:00",
  "durationSec": 41,
  "thumbnailUrl": "https://i.ytimg.com/vi/Y8IJi7iP5vk/maxresdefault.jpg"
}
```

Without `videoDetails`, views are YouTube's rounded numbers ("78M") and there is no date (Shorts grids do not show one).

### Use via API

One request runs the Actor, waits for it and returns the dataset items as JSON. Send your token in the `Authorization` header, not in the URL:

```bash
curl -X POST "https://api.apify.com/v2/acts/atesen-software~youtube-shorts-scraper/run-sync-get-dataset-items?timeout=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channels":["@MrBeast"],"maxShortsPerSource":20}'
```

The synchronous endpoint waits up to 300 seconds. For longer jobs start a run with `POST https://api.apify.com/v2/acts/atesen-software~youtube-shorts-scraper/runs` and read the dataset when it finishes.

**JavaScript** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('atesen-software/youtube-shorts-scraper').call({ channels: ["@MrBeast"], maxShortsPerSource: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Use with AI agents (MCP)

Claude Desktop, Cursor, VS Code and other MCP clients can call this Actor as a tool through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Load only this Actor with:

```text
https://mcp.apify.com?tools=atesen-software/youtube-shorts-scraper
```

Client config (sign in with Apify OAuth when the browser opens, or add an `Authorization: Bearer <APIFY_TOKEN>` header instead):

```json
{
  "mcpServers": {
    "apify": { "url": "https://mcp.apify.com?tools=atesen-software/youtube-shorts-scraper" }
  }
}
```

Then ask in plain words, for example: "List the 20 latest Shorts of @MrBeast with views and publish date." The agent fills the same input fields you see on the Input tab, and runs are billed to your Apify account at the prices on the Pricing tab.

### Pricing

The price per saved Short is shown on the Pricing tab of this Actor and may change over time. Status rows, error rows and empty lookups are free. Set **Maximum cost per run** in the run options and the scraper stops cleanly at your budget.

**Maximum items is a hard cap on charged rows.** Set `maxItems` in the run options (or `?maxItems=` in the API) and the run stops after that many shorts: it never writes or charges more rows than that number. Leave it empty for no cap. Free status rows are not counted.

### Data source and permission

The Actor reads the public Shorts lists that YouTube shows to any visitor on channel and hashtag pages, plus the public watch page when exact details are on. It uses no login and collects only public video and channel data: no viewer, commenter or subscriber identities. YouTube's terms restrict automated access to its service, so the Actor works at a modest pace, stops with a free status row when YouTube refuses a request, and does not try to get around blocks. You are responsible for using the data lawfully and for respecting the rights of the creators. The Actor is not affiliated with YouTube or Google.

### Related actors

- [YouTube Channel Scraper: Export Videos, Shorts & Subscribers](https://apify.com/atesen-software/youtube-channel-scraper)
- [YouTube Comments Scraper: Comments & Replies, No API Key](https://apify.com/atesen-software/youtube-comments-scraper)
- [YouTube Search Scraper: Videos, Views & Rank Tracker](https://apify.com/atesen-software/youtube-search-scraper)

# Actor input Schema

## `channels` (type: `array`):

"@handle", channel URLs or channel IDs.

## `hashtags` (type: `array`):

"#cats", "cats" or https://www.youtube.com/hashtag/cats URLs.

## `maxShortsPerSource` (type: `integer`):

0 = all YouTube shows.

## `sortBy` (type: `string`):

Order of a channel's Shorts tab.

## `videoDetails` (type: `boolean`):

Also load each video's exact publish date, exact view count, likes, comment count, full description, tags/keywords, category and channel subscribers (one extra page load per Short, so the run is slower). Off = fast list data (approximate dates like "3 days ago").

## `maxConcurrency` (type: `integer`):

How many channels/hashtags are scraped at the same time.

## Actor input object example

```json
{
  "channels": [
    "@MrBeast"
  ],
  "maxShortsPerSource": 50,
  "sortBy": "latest",
  "videoDetails": false,
  "maxConcurrency": 3
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `allFields` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channels": [
        "@MrBeast"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("atesen-software/youtube-shorts-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "channels": ["@MrBeast"] }

# Run the Actor and wait for it to finish
run = client.actor("atesen-software/youtube-shorts-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "channels": [
    "@MrBeast"
  ]
}' |
apify call atesen-software/youtube-shorts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,atesen-software/youtube-shorts-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7mWNVyM2U8NdjzQRB/builds/kiACYRlTsgK2IH22h/openapi.json
