# YouTube Video List Scraper (by URL)

Scrape video title, link, channel name, link, total view, publish date, description from YouTube by URL.

- Template page: [https://www.octoparse.com/template/youtube-video-list-scraper-by-url](https://www.octoparse.com/template/youtube-video-list-scraper-by-url)
- Categories: Social Media
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 8 fields, including `Channel_Link`, `Channel_Name`, `Description`, `Keyword`, `Publish_Date`, `Total_Views`, `Video_Link`, `Video_Title`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete YouTube Search URLs, Scroll Times (up to 1,000) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### YouTube Search URLs

Required. YouTube Search URLs Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=999999.

### Scroll Times (up to 1,000)

Required. 1 scroll loads 20 new items. Constraints: minimum=1, maximum=1000.

## How to Use

# YouTube Video List Scraper (by URL)

Collects video listing data from YouTube search URLs. Returns `Video_Title`, `Channel_Name`, `Video_Link`, `Channel_Link`, `Description`, `Publish_Date`, `Keyword`, and `Total_Views`.

## Pricing

This template is **free of charge** (no per-line fee). Octoparse plan or resource limits may still apply.

## Input

Complete the following fields:

- **YouTube Search URLs** (Required) – YouTube search URLs. Up to 10,000 entries per run.
- **Scroll Times** (Required) – 1 scroll loads 20 new items. Accepted range: 1 to 1000.

## Output Fields

- `Keyword`
- `Video_Title`
- `Video_Link`
- `Channel_Name`
- `Channel_Link`
- `Total_Views`
- `Publish_Date`
- `Description`

Example record:

```json
{
  "Keyword": null,
  "Video_Title": "Octoparse Basic Walkthrough#1",
  "Video_Link": "https://www.youtube.com/watch?v=Qmo1zObV5b0&pp=ygUJT2N0b3BhcnNl",
  "Channel_Name": "Octoparse",
  "Channel_Link": "https://www.youtube.com/@Octoparsewebscraping",
  "Total_Views": "29K views",
  "Publish_Date": "2 years ago",
  "Description": "00:00 class 1 01:06 Agenda 01:40 What is Octoparse and how does it works? 03:21 Software interface 06:51 Task template 09:10 ..."
}
```

## How to Use

1. Open **YouTube Video List Scraper (by URL)** and click **Try it!**.
2. Fill in **YouTube Search URLs** and **Scroll Times** using the limits above.
3. Choose a local or cloud run in Octoparse and start the task.
4. Review the output fields and export in your preferred format.

## Tips

- Test one representative search URL before submitting a large batch.
- Keep the `Keyword` field in your export to trace rows back to the originating input.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [YouTube Video List Scraper](https://www.octoparse.com/template/youtube-video-list-scraper)
- [YouTube Comments Scraper (Short Video)](https://www.octoparse.com/template/youtube-comments-scraper-shortvideo)
- [Houzz URL List Scraper](https://www.octoparse.com/template/houzz-url-list-scraper)
- [Zillow Listing Scraper (by URL)](https://www.octoparse.com/template/zillow-scraper)
- [Google Local Service Scraper (by URL)](https://www.octoparse.com/template/google-business-local-services-scraper)

## Input Schema

```json
{
  "title": "YouTube Video List Scraper (by URL) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "youTube_Search_URLs": {
      "title": "YouTube Search URLs",
      "description": "YouTube Search URLs",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 999999
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "scroll_Times": {
      "title": "Scroll Times (up to 1,000)",
      "description": "1 scroll loads 20 new items.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "youTube_Search_URLs",
    "scroll_Times"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "scroll_Times": 1000.0,
  "youTube_Search_URLs": [
    "https://www.youtube.com/@EverydayAI_",
    "https://www.youtube.com/@OpenAI",
    "https://www.youtube.com/results?search_query=artificial+intelligence",
    "https://www.youtube.com/@FutureBusinessTech",
    "https://www.youtube.com/@TheEconomist"
  ]
}
```

Example 2

```json
{
  "scroll_Times": 1000.0,
  "youTube_Search_URLs": [
    "https://www.youtube.com/@EverydayAI_",
    "https://www.youtube.com/@OpenAI",
    "https://www.youtube.com/results?search_query=artificial+intelligence",
    "https://www.youtube.com/@FutureBusinessTech",
    "https://www.youtube.com/@TheEconomist"
  ]
}
```

Example 3

```json
{
  "scroll_Times": 1,
  "youTube_Search_URLs": [
    "https://www.youtube.com/results?search_query=recetas+faciles"
  ]
}
```

Example 4

```json
{
  "scroll_Times": 1000.0,
  "youTube_Search_URLs": [
    "https://www.youtube.com/@EverydayAI_",
    "https://www.youtube.com/@OpenAI",
    "https://www.youtube.com/results?search_query=artificial+intelligence",
    "https://www.youtube.com/@FutureBusinessTech",
    "https://www.youtube.com/@TheEconomist"
  ]
}
```

Example 5

```json
{
  "scroll_Times": 1000.0,
  "youTube_Search_URLs": [
    "https://www.youtube.com/@EverydayAI_",
    "https://www.youtube.com/@OpenAI",
    "https://www.youtube.com/results?search_query=artificial+intelligence",
    "https://www.youtube.com/@FutureBusinessTech",
    "https://www.youtube.com/@TheEconomist"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Channel_Link": {
      "type": "string",
      "description": ""
    },
    "Channel_Name": {
      "type": "string",
      "description": ""
    },
    "Description": {
      "type": "string",
      "description": ""
    },
    "Keyword": {
      "type": "string",
      "description": ""
    },
    "Publish_Date": {
      "type": "string",
      "description": ""
    },
    "Total_Views": {
      "type": "string",
      "description": ""
    },
    "Video_Link": {
      "type": "string",
      "description": ""
    },
    "Video_Title": {
      "type": "string",
      "description": ""
    }
  },
  "title": "YouTube Video List Scraper (by URL) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Channel_Link": "https://www.youtube.com/@airevolutionx",
  "Channel_Name": "AI Revolution",
  "Description": "Superhuman AI could arrive in 2027 as new Anthropic evidence pulls forecasts forward. AI is accelerating its own development, ...",
  "Keyword": "",
  "Publish_Date": "16h ago",
  "Total_Views": "45K",
  "Video_Link": "https://www.youtube.com/watch?v=HPCayerH1Jw&pp=ygUXYXJ0aWZpY2lhbCBpbnRlbGxpZ2VuY2U%3D",
  "Video_Title": "\n            \n            It’s Happening... SUPERHUMAN AI Is Almost Here! (Everything Changes)\n          "
}
```

Example 2

```json
{
  "Channel_Link": "https://www.youtube.com/@LBCOfficial",
  "Channel_Name": "LBC",
  "Description": "Listen to the full show on the all-new LBC App: https://app.af.lbc.co.uk/btnc/thenewlbcapp #benkentish #artificialintelligence ...",
  "Keyword": "",
  "Publish_Date": "1d ago",
  "Total_Views": "47K",
  "Video_Link": "https://www.youtube.com/watch?v=ZfC98aM9C8Y&pp=ygUXYXJ0aWZpY2lhbCBpbnRlbGxpZ2VuY2XSBwkJSQwBhyohjO8%3D",
  "Video_Title": "\n            \n            The 'Godfather of AI' predicts humanity's chance of extinction\n          "
}
```

Example 3

```json
{
  "Channel_Link": "https://www.youtube.com/@QueVivaLaCocina",
  "Channel_Name": "¡Que Viva La Cocina!",
  "Description": "Spaghetti con queso. Espagueti de Pasta rica y sencilla Como hacer una pasta rica y sencilla Recetas faciles y rapidas de cocina.",
  "Keyword": "",
  "Publish_Date": "10y ago",
  "Total_Views": "16M",
  "Video_Link": "https://www.youtube.com/watch?v=ui2EBEi1omM&pp=ygUPcmVjZXRhcyBmYWNpbGVz",
  "Video_Title": "\n            \n            Espaguetis con la salsa más fácil y rica DEL MUNDO - Pasta Recetas faciles\n          "
}
```

Example 4

```json
{
  "Channel_Link": "https://www.youtube.com/@LearnBright",
  "Channel_Name": "Learn Bright",
  "Description": "What exactly is artificial intelligence? Did you know there are different levels? This video for kids discusses how people use AI and ...",
  "Keyword": "",
  "Publish_Date": "1y ago",
  "Total_Views": "632K",
  "Video_Link": "https://www.youtube.com/watch?v=JcXKbUIebrU&pp=ygUXYXJ0aWZpY2lhbCBpbnRlbGxpZ2VuY2U%3D",
  "Video_Title": "\n            \n            What Is AI? | Learn all about artificial intelligence\n          "
}
```

Example 5

```json
{
  "Channel_Link": "https://www.youtube.com/@IBMTechnology",
  "Channel_Name": "IBM Technology",
  "Description": "Learn more about Artificial Intelligence (AI) here → https://ibm.biz/~yBSrYFMHU AI is everywhere, but the terminology can be ...",
  "Keyword": "",
  "Publish_Date": "1mo ago",
  "Total_Views": "1M",
  "Video_Link": "https://www.youtube.com/watch?v=mUw27wG7uFA&pp=ygUXYXJ0aWZpY2lhbCBpbnRlbGxpZ2VuY2U%3D",
  "Video_Title": "\n            \n            AI Simplified: 6 Concepts You Need to Know About Modern AI\n          "
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "youtube-video-list-scraper-by-url",
  "taskName": "YouTube Video List Scraper (by URL)",
  "parameters": "{\"scroll_Times\":1000.0,\"youTube_Search_URLs\":[\"https://www.youtube.com/@EverydayAI_\",\"https://www.youtube.com/@OpenAI\",\"https://www.youtube.com/results?search_query=artificial+intelligence\",\"https://www.youtube.com/@FutureBusinessTech\",\"https://www.youtube.com/@TheEconomist\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"scroll_Times\":1000.0,\"youTube_Search_URLs\":[\"https://www.youtube.com/@EverydayAI_\",\"https://www.youtube.com/@OpenAI\",\"https://www.youtube.com/results?search_query=artificial+intelligence\",\"https://www.youtube.com/@FutureBusinessTech\",\"https://www.youtube.com/@TheEconomist\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "youtube-video-list-scraper-by-url",
        "taskName": "YouTube Video List Scraper (by URL)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "youtube-video-list-scraper-by-url",
  "taskName": "YouTube Video List Scraper (by URL)",
  "parameters": "{\"scroll_Times\":1000.0,\"youTube_Search_URLs\":[\"https://www.youtube.com/@EverydayAI_\",\"https://www.youtube.com/@OpenAI\",\"https://www.youtube.com/results?search_query=artificial+intelligence\",\"https://www.youtube.com/@FutureBusinessTech\",\"https://www.youtube.com/@TheEconomist\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `youtube-video-list-scraper-by-url`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/youtube-video-list-scraper-by-url.json)
- [Manifest](https://www.octoparse.com/templates/youtube-video-list-scraper-by-url-manifest.json)
