# Search YouTube videos by keyword and filters

TikHub

Search YouTube by keyword (filter type=video for videos only)

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Search YouTube videos by keyword and filters (tool ID: tikhub.youtube-search-videos). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search YouTube videos and channels](https://scrollport.com/tools/youtube-data-api)

**Current price:** $0.0028/request

**Availability:** Ready to run

## Tool details

**About this tool**

Search YouTube by keyword (filter type=video for videos only) Retrieve one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. Read public social data without a connected social account. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

**Inputs and outputs**

### Input

`continuation_token` string · optional

pagination token for the next page

minLength: 1 · maxLength: 4096

`duration` string · optional

short ( 20min)

minLength: 1 · maxLength: 500

`features` string · optional

comma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr

minLength: 1 · maxLength: 500

`keyword` string · required

required on the first request; omit when paging with continuation_token

minLength: 1 · maxLength: 500

`sort_by` string · optional

relevance | upload_date | view_count | rating

minLength: 1 · maxLength: 500 · enum: relevance, upload_date, view_count, rating

`type` string · optional

video | channel | playlist | movie

minLength: 1 · maxLength: 500 · enum: video, channel, playlist, movie

`upload_date` string · optional

last_hour | today | this_week | this_month | this_year

minLength: 1 · maxLength: 500

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "tikhub.youtube-search-videos",
  "input": {
    "type": "video",
    "keyword": "coffee"
  }
}
```

### Output

```
{
  "data": {
    "videos": [
      {
        "url": "https://www.youtube.com/watch?v=Gy7nd_A9AIE",
        "title": "COFFEE (Official Music Video) - Amrinder Gill | Jasmeen Akhtar | Navi Brar  | Raj Ranjodh",
        "duration": "2:44",
        "video_id": "Gy7nd_A9AIE",
        "view_count": "26,403,489 views"
      }
    ],
    "keyword": "coffee"
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"keyword":"coffee","type":"video"}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/tikhub/youtube-search-videos