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

# YouTube API

> Durchsuchen Sie YouTube und lesen Sie Videos, Kommentare, Kanäle, Kanal-Uploads und Transkripte als JSON, mit Aufrufen, Likes, Veröffentlichungszeiten, Kapiteln und Untertiteltext.

Lesen Sie öffentliche YouTube-Daten als JSON über die asynchrone Task-API. Senden Sie `taskType` `SOCIAL` mit `platform` `youtube` und wählen Sie mit `action`, was gelesen wird. Eine abgeschlossene Anfrage kostet **0.5 Credits**.

## Anfrage

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "SOCIAL", "payload": { "platform": "youtube", "action": "search", "query": "wireless earbuds review", "limit": 10 } }'
```

Senden Sie den Task und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md).

## Aktionen

| `action` | Liest | Erforderlich |
| - | - | - |
| `search` (Standard) | YouTube-Suchergebnisse | `query` |
| `recent` | Die neuesten Uploads zu einer Suchanfrage, neueste zuerst | `query` |
| `video` | Die Wiedergabeseite eines Videos | `videoId` |
| `comments` | Die Kommentare eines Videos und ihre Antworten | `videoId` |
| `channel` | Angaben und Links eines Kanals | `channel` |
| `channel_videos` | Videos, Shorts oder Livestreams eines Kanals | `channel` |
| `transcript` | Die Untertitel eines Videos | `videoId` |

`videoId` nimmt eine Video-ID oder eine YouTube-Video-URL (Wiedergabe, `youtu.be`, Shorts oder Einbettung). `channel` nimmt eine Kanal-ID (`UC...`), ein `@handle` oder eine Kanal-URL.

## Parameter

`search` und `recent`:

* `query`: Erforderlich. Die Suchanfrage.
* `limit`: Optionale Ganzzahl von 1 bis 50, Standard 10.
* `type`: `video` (Standard), `all`, `shorts`, `channel`, `playlist` oder `movie`.
* `order`: `relevance` (Standard), `viewCount`, `date` oder `rating`. `date` listet Uploads neueste zuerst, wie `recent`. `rating` sortiert die meistgesehenen YouTube-Ergebnisse nach Likes. Suchen nach `channel` und `playlist` nehmen `relevance` oder `viewCount`.
* `publishedAfter`: Eine ISO-8601-Zeit wie `2026-11-01T00:00:00Z`. Liefert Videos, die danach veröffentlicht wurden.
* `videoDuration`: `short` (unter 3 Minuten), `medium` (3 bis 20 Minuten) oder `long` (über 20 Minuten).
* `features`: Beliebige von `live`, `4k`, `hd`, `subtitles`, `creative_commons`, `360`, `vr180`, `3d`, `hdr`, `location` und `purchased`, als Array oder als kommagetrennter String.
* `exactSpelling`: `true` sucht die Anfrage wie geschrieben, ohne YouTubes Rechtschreibkorrektur.
* `pageToken`: Der `nextPageToken` der vorherigen Seite. Videosuchen, die nach `relevance` oder `viewCount` ohne `publishedAfter` sortiert sind, liefern einen, und jede Seite überspringt alle Videos, die frühere Seiten geliefert haben.
* `regionCode` und `languageCode`: Die YouTube-Region (`US`, `KR`, `JP`) und die Oberflächensprache (`en`, `ko`, `ja`), in der gesucht wird.

`comments`:

* `limit`: Optionale Ganzzahl von 1 bis 500, Standard 100. Antworten zählen zum Limit.
* `order`: `relevance` (Standard, YouTubes Top-Kommentare) oder `time` (neueste zuerst).
* `includeReplies`: Optional, Standard `true`.

`channel_videos`:

* `tab`: `videos` (Standard), `shorts` oder `streams`.
* `sort`: `latest` (Standard), `popular` oder `oldest`.
* `limit`: Optionale Ganzzahl von 1 bis 50, Standard 20.

`transcript`:

* `languages`: Untertitelsprachen in bevorzugter Reihenfolge, etwa `["en", "ko"]`. Ohne diesen Parameter werden die Standarduntertitel des Videos gelesen, dann Englisch, dann die erste Spur.
* `isGenerated`: `true` liest nur automatische Untertitel, `false` nur die Untertitel des Uploaders.
* `trackName`: Der Name der Untertitelspur, die gelesen wird.
* `translateTo`: Ein Sprachcode. YouTube übersetzt die Untertitel in diese Sprache.
* `maxSegments`: Optionale Ganzzahl von 1 bis 5.000, Standard 2.000.

## Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "platform": "youtube",
  "action": "search",
  "query": "wireless earbuds review",
  "order": "relevance",
  "totalResults": 4523475,
  "returnedCount": 1,
  "videos": [
    {
      "position": 1,
      "videoId": "YdJh6QdOGME",
      "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
      "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
      "channelId": "UCZZ4ivUawsXRktLKej8d6Xw",
      "channelTitle": "Mike O'Brien",
      "channelHandle": "@MikeOBrienMedia",
      "channelIsVerified": true,
      "publishedAt": "2026-11-17T15:39:37Z",
      "publishedTimeText": "21 hours ago",
      "duration": "PT16M35S",
      "durationSeconds": 995,
      "viewCount": 62618,
      "likeCount": 957,
      "category": "Science & Technology",
      "badges": ["New"],
      "thumbnails": { "high": "https://i.ytimg.com/vi/YdJh6QdOGME/hqdefault.jpg" }
    }
  ],
  "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
}
```

## Ergebnisfelder

* Jede Antwort wiederholt `platform` und `action`. Listen tragen `returnedCount`.
* `search` und `recent` liefern `videos`. Jedes Video hat `position`, `videoId`, `url`, `title`, `description`, die Kanalfelder `channelId`, `channelTitle`, `channelHandle`, `channelUrl`, `channelThumbnail` und `channelIsVerified`, `publishedAt`, `publishedTimeText`, `duration` (ISO 8601), `durationSeconds`, `viewCount`, `likeCount`, `category`, `thumbnails`, `richThumbnail` (die bewegte Vorschau), `badges` und `isFamilySafe`. Ein Film ergänzt `movie` mit Poster, Genre, Jahr, Besetzung und Regie.
* Eine Suche liefert außerdem die `channels`, `playlists`, `shorts` und `shelves`, die die Ergebnisseite zeigt, `totalResults` (YouTubes Schätzung) sowie `didYouMean` oder `showingResultsFor`, wenn YouTube die Anfrage korrigiert.
* `video` ergänzt `tags`, `commentCount`, `subscriberCount`, `hasCaptions`, `chapters`, `mostReplayed`, `music`, `descriptionLinks` und `relatedVideos`. Die Kapitel des Uploaders stehen zuerst, automatische Kapitel tragen `autoGenerated: true`.
* `comments` liefert `comments`, jeweils mit `commentId`, `parentId` (`null` bei einem Kommentar der obersten Ebene), `text`, `authorDisplayName`, `authorChannelId`, `authorProfileImageUrl`, `authorIsVerified`, `authorIsChannelOwner`, `isPinned`, `isHearted`, `likeCount`, `replyCount`, `publishedAt` und `updatedAt`. `totalCount` ist die Zahl, die YouTube anzeigt, und `topLevelCount` und `replyCount` teilen `returnedCount` auf.
* `channel` liefert `channelId`, `title`, `handle`, `description`, `country`, `publishedAt`, `subscriberCount`, `videoCount`, `viewCount`, `isVerified`, `keywords`, `links`, `thumbnails`, `bannerUrl`, `rssUrl` und `uploadsPlaylistId`.
* `channel_videos` liefert `videos` in der Reihenfolge von `sort`, mit `channelId` und `channelTitle` des Kanals.
* `transcript` liefert den Untertiteltext in `text`, zeitgestempelte `segments` (`start` und `duration` in Sekunden), die gelesene `language` und die `availableLanguages`. `truncated: true` kennzeichnet ein bei `maxSegments` abgeschnittenes Transkript.
* Ein Video mit ausgeblendeten Likes trägt `likesHidden: true`, eines mit deaktivierten Kommentaren `commentsDisabled: true`. Ein Video nur für Mitglieder trägt `membersOnly: true` und keinen `viewCount`.
* Ein Video, ein Kanal oder eine Untertitelspur, die es nicht gibt oder die einen angemeldeten Zuschauer verlangt, etwa ein altersbeschränktes Video, beendet den Task mit `PAGE_UNAVAILABLE`. Parameter, die nicht zusammenpassen, beenden ihn mit `BAD_PAYLOAD`. Berechnet werden nur abgeschlossene Anfragen.

## Siehe auch

* [Instagram](https://docs.querying.ai/de/engines/instagram.md)
* [Threads](https://docs.querying.ai/de/engines/threads.md)
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.