> ## 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 Video

> Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish.

Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish.

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

## 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_video',
  {
    "url": "https://example.com"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_youtube_video --input '{
  "url": "https://example.com"
}' --json
```

## Example response

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

## Input reference

Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption tracks (subtitles/captions). isPaidPromotion is true when YouTube marks the video as including paid promotion and false when it does not. Also returns related recommended videos in watchNextVideos. The legacy channel object is unchanged for compatibility and can mix uploader and artist identities on merged music channels. Use uploader for the uploading channel and ownerByline for the channel displayed under the video. ownerByline includes native badge styles and subscriberCountText as YouTube displays it, not an exact subscriber count. descriptionCards contains Music, Games, People mentioned and podcast cards from the structured description. Each card has See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.url` | `string` | Yes | — | YouTube video or short URL |
| `payload.language` | `string` | No | — | Preferred response language (mapped to Accept-Language header. Not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc. |
| `payload.cache_max_age` | `"1d" \| "3d" \| "7d" \| "14d" \| "30d"` | No | — | If we have a response in the cache that is this many days old or newer, return the cached response. Otherwise, scrape a live result. [See the Caching page for details.](https://docs.scrapecreators.com/caching) Allowed: `1d`, `3d`, `7d`, `14d`, `30d`. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption tracks (subtitles/captions). isPaidPromotion is true when YouTube marks the video as including paid promotion and false when it does not. Also returns related recommended videos in watchNextVideos. The legacy channel object is unchanged for compatibility and can mix uploader and artist identities on merged music channels; use uploader for the uploading channel and ownerByline for the channel displayed under the video. ownerByline includes native badge styles and subscriberCountText as YouTube displays it, not an exact subscriber count. descriptionCards contains Music, Games, People mentioned and podcast cards from the structured description. Each card has section, title, subtitle, secondarySubtitle, image, videoId, channelId, playlistId and musicCredits. Missing card fields are null; People mentioned cards can have no linked channel. musicCredits is null when absent, otherwise it includes song, artist, album, writers, licensedToYouTubeBy and the preserved rawText. Owner fields are ownerByline.channelId, name, url, subscriberCountText and badges (style and label). Uploader fields are uploader.channelId, author and url. Either identity can be null when unavailable. An empty array means the description was available with no cards; null means it was unavailable or could not be recognized. isMadeWithAI is true when YouTube exposes the Made with AI disclosure, false when a recognized description has no such disclosure, and null when unknown. This is YouTube disclosure metadata, not our own AI-content detection. Auto-dubbed audio alone does not set isMadeWithAI. aiDisclosure retains the available disclosure text; localized unrecognized disclosures remain unknown. These fields reuse the already-fetched watch page without a separate channel request. When YouTube exposes its public Most replayed graph, most_replayed contains normalized graph buckets in markers and YouTube's highlighted ranges in ranges. The field is null when the graph is not available. YouTube says the graph may be unavailable when the channel has active strikes, the content is potentially inappropriate, the video is too new or has too few views, or its systems deem the video ineligible for another reason. YouTube does not publish fixed age or view-count thresholds. Age-restricted videos return 403 with message: \"This video is age restricted\" because Scrape Creators only uses the public logged-out YouTube source. Need to download a YouTube video? We open sourced our [YouTube downloader](https://github.com/ScrapeCreators/youtube-downloader). You can use it and host it wherever you want. We don't offer a hosted YouTube downloading service because it's expensive and compute-intensive to run.",
    "properties": {
      "url": {
        "type": "string",
        "description": "YouTube video or short URL"
      },
      "language": {
        "type": "string",
        "description": "Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc."
      },
      "cache_max_age": {
        "type": "string",
        "description": "If we have a response in the cache that is this many days old or newer, return the cached response. Otherwise, scrape a live result. [See the Caching page for details.](https://docs.scrapecreators.com/caching)",
        "enum": [
          "1d",
          "3d",
          "7d",
          "14d",
          "30d"
        ]
      }
    },
    "required": [
      "url"
    ],
    "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: `provider_usage` (provider usage).
* 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.