# YouTube channel

Get a YouTube channel's profile, videos, Shorts, playlists and posts. Takes channel id, tab, sort and more, all optional. Served by Litescrape.

Get a YouTube channel's profile, videos, Shorts, playlists and posts. Fresh requests only; saved-query and conversation continuation tokens are not supported.

- Tool ID: `litescrape/youtube-channel`
- Name in the catalog: YouTube Channel
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [YouTube channels](/tools/youtube/channels.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "channel_id": {
      "anyOf": [
        {
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Channel handle (with or without @) or a UC channel ID. Required on the first page; omit with next_page_token.\n\nRequired on the first page. Use a handle such as @veritasium or a UC channel ID; full URLs are not accepted."
    },
    "tab": {
      "anyOf": [
        {
          "enum": [
            "videos",
            "shorts",
            "streams",
            "podcasts",
            "playlists",
            "posts"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Channel content tab. Defaults to videos. Omit when using search_query or next_page_token. Not every channel offers every tab.\n\nA channel without the requested tab returns an empty content group with search_information.tab_available set to false."
    },
    "sort": {
      "anyOf": [
        {
          "enum": [
            "latest",
            "popular",
            "oldest",
            "dd",
            "lad"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "videos, shorts and streams accept latest, popular or oldest; playlists accept dd (newest playlist) or lad (last video added). Omit with podcasts, posts, search_query or next_page_token.\n\nVideos, Shorts and streams default to latest. Playlists default to dd. Sorting uses the choices offered by YouTube."
    },
    "search_query": {
      "anyOf": [
        {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Search within this channel for matching videos and playlists. Cannot be combined with tab or sort. Omit with next_page_token.\n\nOmit tab and sort when searching. Matching videos and playlists appear in search_results."
    },
    "hl": {
      "anyOf": [
        {
          "pattern": "^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8}){0,2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Interface language, such as en or pt-BR. Defaults to en. Omit with next_page_token."
    },
    "gl": {
      "anyOf": [
        {
          "pattern": "^[A-Za-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Two-letter country code. Defaults to US. Omit with next_page_token."
    },
    "about": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Include additional public channel details, such as country, join date, total views and links. Defaults to false. Omit with next_page_token.\n\nChannel profile data is returned on the first page. about=true includes additional public details. Continuation pages return content only."
    }
  },
  "type": "object",
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "channel_id"
          ],
          "properties": {
            "channel_id": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        }
      ]
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/youtube-channel",
  "input": {
    "channel_id": "veritasium",
    "tab": "videos"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#youtube-channel-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/youtube-channel) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/youtube-channel) · [Agent index](/llms.txt)