> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ScrapeCreators: Youtube Channel Videos

> List a YouTube channel's videos by handle or channel ID, latest or most popular, with title, thumbnail, views, publish date and length. page.

List a YouTube channel's videos by handle or channel ID, latest or most popular, with title, thumbnail, views, publish date and length. page.

> [!NOTE]
>
> Tool ID: `scrapecreators_youtube_channel_videos`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_youtube_channel_videos',
  {
    "channelId": "channel_123",
    "handle": "example",
    "sort": "latest"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_youtube_channel_videos --input '{
  "channelId": "channel_123",
  "handle": "example",
  "sort": "latest"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe scrapecreators_youtube_channel_videos --json` for the complete live contract.

## Input reference

Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. Supports sorting by latest or popular, and use the continuationToken to page through all results. Optionally include extras like like count, comment count, and descriptions for each video. Paid-promotion filtering is not supported on this endpoint. Use /v1/youtube/video and read isPaidPromotion to check each video's paid-promotion status.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.channelId` | `string` | No | — | YouTube channel ID |
| `payload.handle` | `string` | No | — | YouTube channel handle |
| `payload.sort` | `"latest" \| "popular"` | No | — | Sort by latest or popular Allowed: `latest`, `popular`. |
| `payload.includeExtras` | `string` | No | — | This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future. |
| `payload.continuationToken` | `string` | No | — | Continuation token to get more videos. Get 'continuationToken' from previous response. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. Supports sorting by latest or popular, and use the continuationToken to page through all results. Optionally include extras like like count, comment count, and descriptions for each video. Paid-promotion filtering is not supported on this endpoint. Use /v1/youtube/video and read isPaidPromotion to check each video's paid-promotion status.",
    "properties": {
      "channelId": {
        "type": "string",
        "description": "YouTube channel ID"
      },
      "handle": {
        "type": "string",
        "description": "YouTube channel handle"
      },
      "sort": {
        "type": "string",
        "description": "Sort by latest or popular",
        "enum": [
          "latest",
          "popular"
        ]
      },
      "includeExtras": {
        "type": "string",
        "description": "This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future."
      },
      "continuationToken": {
        "type": "string",
        "description": "Continuation token to get more videos. Get 'continuationToken' from previous response."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `unknown` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.02` per pricing unit.

## Related documentation

* [ScrapeCreators provider guide](https://deepline.com/docs/providers/scrapecreators/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.