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

# YouTube videos

> YouTube videos from a search term, channel, playlist or direct URL, with title, channel, view and like counts, duration, upload date, description and hashtags.

YouTube videos from a search term, channel, playlist or direct URL, with title, channel, view and like counts, duration, upload date, description and hashtags.

<Note>Use to find videos on a topic, pull a channel's or playlist's catalogue, or enrich known video URLs with their stats. Subtitles and the two AI add-ons are billed extra per video, so leave them off unless you need them.</Note>

## Price

**\$0.0090 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field         | Type                                     | Required | Notes                                                                                                                                |
| ------------- | ---------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `is3D`        | `boolean`                                |          | searchQueries filter: 3D videos only.                                                                                                |
| `is4K`        | `boolean`                                |          | searchQueries filter: 4K videos only.                                                                                                |
| `isHD`        | `boolean`                                |          | searchQueries filter: HD videos only.                                                                                                |
| `hasCC`       | `boolean`                                |          | searchQueries filter: Creative Commons licensed videos only.                                                                         |
| `is360`       | `boolean`                                |          | searchQueries filter: 360 degree videos only.                                                                                        |
| `isHDR`       | `boolean`                                |          | searchQueries filter: HDR videos only.                                                                                               |
| `isLive`      | `boolean`                                |          | searchQueries filter: live videos only.                                                                                              |
| `isVR180`     | `boolean`                                |          | searchQueries filter: VR180 videos only.                                                                                             |
| `isBought`    | `boolean`                                |          | searchQueries filter: purchased videos only.                                                                                         |
| `startUrls`   | `array`                                  |          | Direct YouTube video, channel, playlist, hashtag or results-page URLs                                                                |
| `videoType`   | `video`, `movie`                         |          |                                                                                                                                      |
| `dateFilter`  | `hour`, `today`, `week`, `month`, `year` |          | Upload-date filter for search. COSTS EXTRA on channel inputs: the date-range add-on is billed \$0.001 per video on top of the result |
| `maxResults`  | `integer`                                |          | Maximum regular videos per search term or channel. Billed per video Defaults to `10`.                                                |
| `hasLocation` | `boolean`                                |          | searchQueries filter: videos tagged with a location.                                                                                 |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"youtube.videos","input":{"maxResults":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "5kcaHAuGxmY",
  "url": "https://www.youtube.com/watch?v=5kcaHAuGxmY",
  "date": "2024-08-21T17:50:32.000Z",
  "text": "Scrape data from any website with this Web Scraper API from Apify Store.",
  "type": "video",
  "input": "apify web scraping",
  "likes": 343,
  "title": "How to scrape ANY website with Apify's Web Scraper API",
  "duration": "00:05:30",
  "hashtags": [
    "#webscraping",
    "#coding"
  ],
  "channelId": "UCTgwcoeGGKmZ3zzCXN2qo_A",
  "subtitles": null,
  "viewCount": 40106,
  "channelUrl": "https://www.youtube.com/@Apify",
  "channelName": "Apify",
  "thumbnailUrl": "https://i.ytimg.com/vi/5kcaHAuGxmY/maxresdefault.jpg",
  "commentsCount": 44,
  "aiVideoSummary": null,
  "channelUsername": "Apify",
  "aiVideoDescription": null,
  "numberOfSubscribers": 16200
}
```