taskType SOCIAL con platform youtube y elige qué leer con action. Cada solicitud completada cuesta 0.5 créditos.
Solicitud
GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.
Acciones
videoId acepta un ID de video o una URL de video de YouTube (reproducción, youtu.be, Shorts o insertado). channel acepta un ID de canal (UC...), un @handle o una URL de canal.
Parámetros
search y recent:
query: Obligatorio. La consulta de búsqueda.limit: Entero opcional de 1 a 50, con 10 por defecto.type:video(por defecto),all,shorts,channel,playlistomovie.order:relevance(por defecto),viewCount,dateorating.datelista las subidas de la más nueva a la más antigua, comorecent.ratingordena por número de me gusta los resultados más vistos de YouTube. Las búsquedas dechannelyplaylistaceptanrelevanceoviewCount.publishedAfter: Una hora ISO 8601, como2026-11-01T00:00:00Z. Devuelve los videos publicados después de ella.videoDuration:short(menos de 3 minutos),medium(de 3 a 20 minutos) olong(más de 20 minutos).features: Cualquiera delive,4k,hd,subtitles,creative_commons,360,vr180,3d,hdr,locationypurchased, como array o como cadena separada por comas.exactSpelling:truebusca la consulta tal como está escrita, sin la corrección ortográfica de YouTube.pageToken: ElnextPageTokende la página anterior. Las búsquedas de videos ordenadas porrelevanceoviewCountsinpublishedAfterdevuelven uno, y cada página omite todos los videos que devolvieron las páginas anteriores.regionCodeylanguageCode: La región de YouTube (US,KR,JP) y el idioma de la interfaz (en,ko,ja) en que se busca.
comments:
limit: Entero opcional de 1 a 500, con 100 por defecto. Las respuestas cuentan para el límite.order:relevance(por defecto, los comentarios destacados de YouTube) otime(los más nuevos primero).includeReplies: Opcional, contruepor defecto.
channel_videos:
tab:videos(por defecto),shortsostreams.sort:latest(por defecto),popularooldest.limit: Entero opcional de 1 a 50, con 20 por defecto.
transcript:
languages: Idiomas de subtítulos en orden de preferencia, como["en", "ko"]. Sin este parámetro se leen los subtítulos predeterminados del video, luego los de inglés y luego la primera pista.isGenerated:truelee solo los subtítulos automáticos, yfalse, solo los del autor del video.trackName: El nombre de la pista de subtítulos que se lee.translateTo: Un código de idioma. YouTube traduce los subtítulos a ese idioma.maxSegments: Entero opcional de 1 a 5.000, con 2.000 por defecto.
Ejemplo de respuesta
Campos del resultado
- Cada respuesta repite
platformyaction. Las listas incluyenreturnedCount. searchyrecentdevuelvenvideos. Cada video tieneposition,videoId,url,title,description, loschannelId,channelTitle,channelHandle,channelUrl,channelThumbnailychannelIsVerifieddel canal,publishedAt,publishedTimeText,duration(ISO 8601),durationSeconds,viewCount,likeCount,category,thumbnails,richThumbnail(la vista previa animada),badgeseisFamilySafe. Una película añademoviecon su póster, género, año, reparto y director.- Una búsqueda también devuelve los
channels,playlists,shortsyshelvesque muestra la página de resultados,totalResults(la estimación de YouTube) ydidYouMeanoshowingResultsForcuando YouTube corrige la consulta. videoañadetags,commentCount,subscriberCount,hasCaptions,chapters,mostReplayed,music,descriptionLinksyrelatedVideos. Los capítulos del autor van primero, y los capítulos automáticos llevanautoGenerated: true.commentsdevuelvecomments, cada uno concommentId,parentId(nullen un comentario de primer nivel),text,authorDisplayName,authorChannelId,authorProfileImageUrl,authorIsVerified,authorIsChannelOwner,isPinned,isHearted,likeCount,replyCount,publishedAtyupdatedAt.totalCountes el recuento que muestra YouTube, ytopLevelCountyreplyCountdesglosanreturnedCount.channeldevuelvechannelId,title,handle,description,country,publishedAt,subscriberCount,videoCount,viewCount,isVerified,keywords,links,thumbnails,bannerUrl,rssUrlyuploadsPlaylistId.channel_videosdevuelvevideosen el orden desort, con elchannelIdy elchannelTitledel canal.transcriptdevuelve eltextde los subtítulos, lossegmentscon tiempos (startydurationen segundos), ellanguageleído y losavailableLanguages.truncated: truemarca una transcripción cortada enmaxSegments.- Un video con los me gusta ocultos lleva
likesHidden: true, y uno con los comentarios desactivados llevacommentsDisabled: true. Un video solo para miembros llevamembersOnly: truey no tieneviewCount. - Un video, canal o pista de subtítulos que no existe, o que requiere un espectador con sesión iniciada, como un video con restricción de edad, termina la tarea con
PAGE_UNAVAILABLE. Los parámetros que no encajan entre sí la terminan conBAD_PAYLOAD. Solo se cobran las solicitudes completadas.