# Get YouTube video (POST) | Parsium Docs

Source: https://docs.parseium.com/api/operations/youtubevideopost/

# Get YouTube video (POST)

POST

/v1/youtube-video

Extract video metadata, view/like counts, and tags from a YouTube video.

Provide either `video_id` or `url`.

**Credits:** 1 per request.

Accepts the same fields as JSON instead of query parameters.

## Authorizations

 Section titled “Authorizations ”

- **[apiKeyHeader](/api/#apikeyheader)**
- **[apiKeyQuery](/api/#apikeyquery)**

## Request Body
required

 Section titled “Request Body
required
 ”

 Select media type application/json

 object

 video_id

YouTube video ID.

 string

 url

YouTube video URL.

 string

## Responses

 Section titled “
Responses
”

### 200

 Section titled “200 ”

Extracted data.

 Select media type application/json

 object

 id

 string

 type

 string

 title

 string

 description

 string

 thumbnail

 string

 channel

 object

 id

 string

 url

 string

 handle

 string

 title

 string

 viewCountText

 string

 viewCountInt

 number

 likeCountText

 string

 likeCountInt

 number

 commentCountText

 string

 commentCountInt

 number

 publishDateText

 string

 publishDate

 string

 durationMs

 number

 durationFormatted

 string

 keywords

 Array<string>

 watchNextVideos

 Array<object>

 object

 id

 string

 title

 string

 thumbnail

 string

 videoUrl

 string

 channel

 object

 id

 string

 url

 string

 handle

 string

 title

 string

 viewCountText

 string

 viewCountInt

 number

 publishDateText

 string

 publishDate

 string

 lengthText

 string

 transcript

 Array<object>

 object

 text

 string

 startMs

 string

 endMs

 string

 startTimeText

 string

 transcript_only_text

 string

#### Headers

 Section titled “Headers ”

 X-Credits-Used

 integer

Credits consumed.

 X-Credits-Remaining

 integer

Remaining credit balance.

### 401

 Section titled “401 ”

Missing or invalid API key.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 402

 Section titled “402 ”

Insufficient unreserved credits.

 Select media type application/json

 object

 error

required

 string

##### Example

```
insufficient credits
```

 required

required

 integer

 available

required

 integer

### 429

 Section titled “429 ”

Request, concurrency, or plan limit exceeded.

 Select media type application/json

 One of:

- [object](#tab-panel-68)
- [object](#tab-panel-69)

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

 object

 error

required

 string

##### Example

```
pending limit
```

 pending

required

 integer

 limit

required

 integer

 accepted

required

 integer

0

#### Headers

 Section titled “Headers ”

 Retry-After

 integer

Seconds to wait when supplied.