# Search YouTube (POST) | Parsium Docs

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

# Search YouTube (POST)

POST

/v1/youtube-search

Search YouTube videos with pagination.

**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

 query

Search query.

 string

 continuation

Pagination token from previous response.

 string

## Responses

 Section titled “
Responses
”

### 200

 Section titled “200 ”

Extracted data.

 Select media type application/json

 object

 videos

 Array<object>

 object

 type

 string

 id

 string

 url

 string

 title

 string

 description

 string

 thumbnail

 string

 view_count_text

 string

 view_count_int

 number

 published_time_text

 string

 published_time

 string

 length_text

 string

 length_seconds

 number

 channel_id

 string

 channel_name

 string

 channel_url

 string

 badges

 Array<string>

 shorts

 Array<object>

 object

 type

 string

 id

 string

 url

 string

 title

 string

 thumbnail

 string

 view_count_text

 string

 view_count_int

 number

 channels

 Array<object>

 object

 type

 string

 id

 string

 url

 string

 name

 string

 handle

 string

 thumbnail

 string

 description

 string

 subscriber_count

 string

 video_count

 string

 continuation_token

 string

 has_more

 boolean

#### 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-88)
- [object](#tab-panel-89)

 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.