taskType SOCIAL mit platform youtube und wählen Sie mit action, was gelesen wird. Eine abgeschlossene Anfrage kostet 0.5 Credits.
Anfrage
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,playlistodermovie.order:relevance(Standard),viewCount,dateoderrating.datelistet Uploads neueste zuerst, wierecent.ratingsortiert die meistgesehenen YouTube-Ergebnisse nach Likes. Suchen nachchannelundplaylistnehmenrelevanceoderviewCount.publishedAfter: Eine ISO-8601-Zeit wie2026-11-01T00:00:00Z. Liefert Videos, die danach veröffentlicht wurden.videoDuration:short(unter 3 Minuten),medium(3 bis 20 Minuten) oderlong(über 20 Minuten).features: Beliebige vonlive,4k,hd,subtitles,creative_commons,360,vr180,3d,hdr,locationundpurchased, als Array oder als kommagetrennter String.exactSpelling:truesucht die Anfrage wie geschrieben, ohne YouTubes Rechtschreibkorrektur.pageToken: DernextPageTokender vorherigen Seite. Videosuchen, die nachrelevanceoderviewCountohnepublishedAftersortiert sind, liefern einen, und jede Seite überspringt alle Videos, die frühere Seiten geliefert haben.regionCodeundlanguageCode: 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) odertime(neueste zuerst).includeReplies: Optional, Standardtrue.
channel_videos:
tab:videos(Standard),shortsoderstreams.sort:latest(Standard),popularoderoldest.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:trueliest nur automatische Untertitel,falsenur 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
platformundaction. Listen tragenreturnedCount. searchundrecentliefernvideos. Jedes Video hatposition,videoId,url,title,description, die KanalfelderchannelId,channelTitle,channelHandle,channelUrl,channelThumbnailundchannelIsVerified,publishedAt,publishedTimeText,duration(ISO 8601),durationSeconds,viewCount,likeCount,category,thumbnails,richThumbnail(die bewegte Vorschau),badgesundisFamilySafe. Ein Film ergänztmoviemit Poster, Genre, Jahr, Besetzung und Regie.- Eine Suche liefert außerdem die
channels,playlists,shortsundshelves, die die Ergebnisseite zeigt,totalResults(YouTubes Schätzung) sowiedidYouMeanodershowingResultsFor, wenn YouTube die Anfrage korrigiert. videoergänzttags,commentCount,subscriberCount,hasCaptions,chapters,mostReplayed,music,descriptionLinksundrelatedVideos. Die Kapitel des Uploaders stehen zuerst, automatische Kapitel tragenautoGenerated: true.commentsliefertcomments, jeweils mitcommentId,parentId(nullbei einem Kommentar der obersten Ebene),text,authorDisplayName,authorChannelId,authorProfileImageUrl,authorIsVerified,authorIsChannelOwner,isPinned,isHearted,likeCount,replyCount,publishedAtundupdatedAt.totalCountist die Zahl, die YouTube anzeigt, undtopLevelCountundreplyCountteilenreturnedCountauf.channelliefertchannelId,title,handle,description,country,publishedAt,subscriberCount,videoCount,viewCount,isVerified,keywords,links,thumbnails,bannerUrl,rssUrlunduploadsPlaylistId.channel_videosliefertvideosin der Reihenfolge vonsort, mitchannelIdundchannelTitledes Kanals.transcriptliefert den Untertiteltext intext, zeitgestempeltesegments(startunddurationin Sekunden), die gelesenelanguageund dieavailableLanguages.truncated: truekennzeichnet ein beimaxSegmentsabgeschnittenes Transkript.- Ein Video mit ausgeblendeten Likes trägt
likesHidden: true, eines mit deaktivierten KommentarencommentsDisabled: true. Ein Video nur für Mitglieder trägtmembersOnly: trueund keinenviewCount. - 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 mitBAD_PAYLOAD. Berechnet werden nur abgeschlossene Anfragen.