Zum Hauptinhalt springen
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

Senden Sie den Task und fragen Sie dann GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks.

Aktionen

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

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