Get videos with tag - KonbiniAPI Docs

What it does

Returns videos tagged with a YouTube hashtag. Not paginated — YouTube returns a single page of results for a hashtag.

Tool details

Field	Value
Tool name	`youtube_get_tag_videos`
Platform	YouTube
REST endpoint	`GET /v1/youtube/tags/{tag}`
Result type	Detail tool

Parameters

Parameter	Type	Required	Description
`tag`	`string`	Yes	Tag name, with or without a leading ”#“
`projection_preset`	`string`	No	Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`.
`data_fields`	`string[]`	No	Adds top-level keys from `data` on top of the selected `projection_preset`.

Example

{
  "name": "youtube_get_tag_videos",
  "arguments": {
    "tag": "mrbeast",
    "projection_preset": "minimal",
    "data_fields": [
      "totalItems",
      "type",
      "items"
    ]
  }
}

Available data fields

@context
type
totalItems
items

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.