# YouTube Video Details Scraper (`neuro-scraper/youtube-video-details-scraper`)

"🎬 Scrape YouTube video details in seconds! This actor extracts 🔑 info like title, description, views 👀, likes 👍, upload date 📅, and channel details 📺 — perfect for research, analytics, or content tracking. Get unlimited data for low cost per month 🤑😱 "

- **URL**: https://beta-securitybyobscurity.apify.com/neuro-scraper/youtube-video-details-scraper.md
- **Developed by:** [Neuro Scraper](https://beta-securitybyobscurity.apify.com/neuro-scraper) (community)
- **Categories:** Automation, Social media, Other
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$4.50/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## 🎯 YouTube Video Metadata Scraper

Lightning-fast extraction of detailed YouTube video data into JSON for analytics, automation, or reporting.

### 📖 Summary

Scrape metadata from YouTube videos or playlists including title, channel, views, likes, tags, description, and more.

### 💡 Use Cases

- Extract video details for analytics dashboards
- Monitor competitor channels or video performance
- Generate structured reports from playlists
- Automate content research

### ⚡ Quick Start — Apify Console

1. Go to the Actor page in Apify Console.
2. Click **Run**.
3. Paste an array of YouTube URLs in `startUrls`.
4. (Optional) Enable Apify Proxy or provide custom proxies in the **Proxy** panel.
5. Click **Start**.

### ⚡ Quick Start — CLI + API

#### CLI

```bash
apify run --actor <ACTOR_ID> -p input.json
```

#### Python API (apify-client)

```python
from apify_client import ApifyClient

client = ApifyClient('<APIFY_TOKEN>')

run_input = {
    'startUrls': ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'],
    'proxyConfiguration': {'useApifyProxy': True}
}

run = client.acts.run_actor('<ACTOR_ID>', run_input=run_input)
print(run['defaultDatasetId'])
```

### 📝 Inputs

- `startUrls`: List of YouTube video or playlist URLs.
- `proxyConfiguration`: Object to configure proxy usage.

### ⚙️ Configuration

| 🔑 **Name**          | 📝 **Type**         | ❓ **Required** | ⚙️ **Default** | 📌 **Example**                                    | 📝 **Notes**                    |
| -------------------- | ------------------- | -------------- | -------------- | ------------------------------------------------- | ------------------------------- |
| `startUrls`          | `array`             | ✅ Yes          | `null`         | `["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]` | List of target YouTube URLs     |
| `proxyConfiguration` | `object`            | ⚙️ Optional    | `{}`           | `{ "useApifyProxy": true }`                       | Proxy settings for requests     |
| `ALL_RESULTS`        | `dataset/key-value` | ⚙️ Optional    | `default`      | `ALL_RESULTS`                                     | Key for storing all output data |

**Console example:** Paste `startUrls` in input JSON panel or set `APIFY_TOKEN` env variable in Actor settings.

### 📤 Outputs

- **Dataset**: JSON objects for each video containing metadata.

Example output item:

```json
{
  "title": "Example Video",
  "channel": "Channel Name",
  "channel_id": "UC1234567890",
  "views": 12345,
  "likes": 678,
  "dislikes": 10,
  "upload_date": "20250101",
  "duration": 300,
  "tags": ["tag1", "tag2"],
  "categories": ["Entertainment"],
  "description": "Video description...",
  "thumbnail": "https://example.com/thumb.jpg",
  "age_limit": 0,
  "comment_count": 45,
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

### 🔑 Environment Variables

- `APIFY_TOKEN` — your Apify account token.

### ▶️ How to Run

- **Console:** Run Actor → paste input JSON → Start.
- **CLI:** `apify run --actor <ACTOR_ID> -p input.json`
- **apify-client:** See Python example above.

### ⏰ Scheduling & Webhooks

- Configure schedules in the **Scheduler** panel.
- Add webhooks in **Webhook** settings to trigger external callbacks.

### 🐞 Logs & Troubleshooting

- ❌ Missing URLs → ensure `startUrls` is provided.
- ⚠️ Proxy errors → check proxy configuration and credentials.
- ⚠️ Private video errors → may require login cookies.

### 🔒 Permissions & Storage Notes

- Actor stores output in default dataset; ensure access to Apify storage.
- Proxy credentials should be stored as **secrets**.

### 🆕 Changelog / Versioning Tip

- Increment version for major feature additions.
- Patch releases for bug fixes.

### 🌍 Proxy Configuration

- **Enable Apify Proxy:** In Console, go to **Proxy** panel → toggle **Use Apify Proxy** ✅
- **Custom Proxy:** Set `HTTP_PROXY` / `HTTPS_PROXY` env vars, e.g.,
  `http://<PROXY_USER:PROXY_PASS@HOST:PORT>`
- **Security:** Always store credentials as **secrets** 🔒
- TODO: Add advanced rotating proxy patterns if scraping large playlists.

### 📚 References

- [Apify Actor README Guide](https://docs.apify.com/actors/actor-readme)
- [Apify Input & Output Docs](https://docs.apify.com/actors/input-output)
- [Apify CLI Docs](https://docs.apify.com/cli)

### 🧐 Inferred from main.py

- Supports multiple YouTube URLs or playlist links.
- Uses optional proxy configuration.
- Extracts detailed video metadata.
- TODO: Confirm support for private videos requiring login cookies.

***

## input.example.json

{
"startUrls": \[
"<https://www.youtube.com/watch?v=dQw4w9WgXcQ>"
],
"proxyConfiguration": {
"useApifyProxy": true
}
}

***

## CONFIG.md

## Configuration Reference

| 🔑 **Name**          | 📝 **Type**         | ❓ **Required** | ⚙️ **Default** | 📌 **Example**                                    | 📝 **Notes**                    |
| -------------------- | ------------------- | -------------- | -------------- | ------------------------------------------------- | ------------------------------- |
| `startUrls`          | `array`             | ✅ Yes          | `null`         | `["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]` | List of target YouTube URLs     |
| `proxyConfiguration` | `object`            | ⚙️ Optional    | `{}`           | `{ "useApifyProxy": true }`                       | Proxy settings for requests     |
| `ALL_RESULTS`        | `dataset/key-value` | ⚙️ Optional    | `default`      | `ALL_RESULTS`                                     | Key for storing all output data |

**Example Console input:**

```json
{
  "startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]
}
```

# Actor input Schema

## `startUrls` (type: `array`):

List of one or more YouTube video or playlist URLs

## `proxyConfiguration` (type: `object`):

Use Apify Proxy or your own HTTP proxies

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/youtube-video-details-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 = {
    "startUrls": [{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }],
    "proxyConfiguration": { "useApifyProxy": False },
}

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

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call neuro-scraper/youtube-video-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=neuro-scraper/youtube-video-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "YouTube Video Details Scraper",
        "description": "\"🎬 Scrape YouTube video details in seconds! This actor extracts 🔑 info like title, description, views 👀, likes 👍, upload date 📅, and channel details 📺 — perfect for research, analytics, or content tracking. Get unlimited data for low cost per month 🤑😱 \"",
        "version": "0.0",
        "x-build-id": "fTuIkb7kDmaVuhq92"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/neuro-scraper~youtube-video-details-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-neuro-scraper-youtube-video-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/neuro-scraper~youtube-video-details-scraper/runs": {
            "post": {
                "operationId": "runs-sync-neuro-scraper-youtube-video-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/neuro-scraper~youtube-video-details-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-neuro-scraper-youtube-video-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "List of one or more YouTube video or playlist URLs",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Use Apify Proxy or your own HTTP proxies",
                        "default": {}
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
