[{"data":1,"prerenderedAt":392},["ShallowReactive",2],{"doc-api\u002Fbatch":3},{"id":4,"title":5,"author":6,"body":7,"date":375,"description":376,"draft":377,"extension":378,"faq":379,"meta":380,"navigation":381,"path":382,"schemaType":383,"seo":384,"stem":385,"tags":386,"updatedAt":390,"__hash__":391},"content\u002Fapi\u002Fbatch.md","Batch processing","YT2Text Team",{"type":8,"value":9,"toc":367},"minimark",[10,15,24,29,53,57,60,65,68,250,253,284,289,292,295,317,322,325,345,348,355,360,363],[11,12,14],"h1",{"id":13},"batch-api","Batch API",[16,17,18,19,23],"p",{},"Batch endpoints live under ",[20,21,22],"code",{},"\u002Fapi\u002Fv1\u002Fbatch",".",[25,26,28],"h2",{"id":27},"endpoints","Endpoints",[30,31,32,38,43,48],"ul",{},[33,34,35],"li",{},[20,36,37],{},"POST \u002Fapi\u002Fv1\u002Fbatch\u002Fprocess",[33,39,40],{},[20,41,42],{},"GET \u002Fapi\u002Fv1\u002Fbatch\u002Fstatus\u002F{batch_id}",[33,44,45],{},[20,46,47],{},"GET \u002Fapi\u002Fv1\u002Fbatch\u002Fresults\u002F{batch_id}",[33,49,50],{},[20,51,52],{},"GET \u002Fapi\u002Fv1\u002Fbatch\u002F",[25,54,56],{"id":55},"availability","Availability",[16,58,59],{},"Batch processing is available on Pro\u002FAdmin plans.",[25,61,63],{"id":62},"post-apiv1batchprocess",[20,64,37],{},[16,66,67],{},"Request body:",[69,70,75],"pre",{"className":71,"code":72,"language":73,"meta":74,"style":74},"language-json shiki shiki-themes github-light github-dark","{\n  \"videos\": [\n    {\n      \"url\": \"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_1\",\n      \"options\": {\n        \"summary_modes\": [\"tldr\"]\n      }\n    },\n    {\n      \"url\": \"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_2\",\n      \"options\": {\n        \"summary_modes\": [\"detailed\"]\n      }\n    }\n  ],\n  \"webhook_url\": \"https:\u002F\u002Fexample.com\u002Fbatch-webhook\",\n  \"priority\": \"normal\",\n  \"parallel_processing\": true\n}\n","json","",[20,76,77,86,96,102,118,127,142,148,154,159,171,178,190,195,201,207,220,233,244],{"__ignoreMap":74},[78,79,82],"span",{"class":80,"line":81},"line",1,[78,83,85],{"class":84},"sVt8B","{\n",[78,87,89,93],{"class":80,"line":88},2,[78,90,92],{"class":91},"sj4cs","  \"videos\"",[78,94,95],{"class":84},": [\n",[78,97,99],{"class":80,"line":98},3,[78,100,101],{"class":84},"    {\n",[78,103,105,108,111,115],{"class":80,"line":104},4,[78,106,107],{"class":91},"      \"url\"",[78,109,110],{"class":84},": ",[78,112,114],{"class":113},"sZZnC","\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_1\"",[78,116,117],{"class":84},",\n",[78,119,121,124],{"class":80,"line":120},5,[78,122,123],{"class":91},"      \"options\"",[78,125,126],{"class":84},": {\n",[78,128,130,133,136,139],{"class":80,"line":129},6,[78,131,132],{"class":91},"        \"summary_modes\"",[78,134,135],{"class":84},": [",[78,137,138],{"class":113},"\"tldr\"",[78,140,141],{"class":84},"]\n",[78,143,145],{"class":80,"line":144},7,[78,146,147],{"class":84},"      }\n",[78,149,151],{"class":80,"line":150},8,[78,152,153],{"class":84},"    },\n",[78,155,157],{"class":80,"line":156},9,[78,158,101],{"class":84},[78,160,162,164,166,169],{"class":80,"line":161},10,[78,163,107],{"class":91},[78,165,110],{"class":84},[78,167,168],{"class":113},"\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_2\"",[78,170,117],{"class":84},[78,172,174,176],{"class":80,"line":173},11,[78,175,123],{"class":91},[78,177,126],{"class":84},[78,179,181,183,185,188],{"class":80,"line":180},12,[78,182,132],{"class":91},[78,184,135],{"class":84},[78,186,187],{"class":113},"\"detailed\"",[78,189,141],{"class":84},[78,191,193],{"class":80,"line":192},13,[78,194,147],{"class":84},[78,196,198],{"class":80,"line":197},14,[78,199,200],{"class":84},"    }\n",[78,202,204],{"class":80,"line":203},15,[78,205,206],{"class":84},"  ],\n",[78,208,210,213,215,218],{"class":80,"line":209},16,[78,211,212],{"class":91},"  \"webhook_url\"",[78,214,110],{"class":84},[78,216,217],{"class":113},"\"https:\u002F\u002Fexample.com\u002Fbatch-webhook\"",[78,219,117],{"class":84},[78,221,223,226,228,231],{"class":80,"line":222},17,[78,224,225],{"class":91},"  \"priority\"",[78,227,110],{"class":84},[78,229,230],{"class":113},"\"normal\"",[78,232,117],{"class":84},[78,234,236,239,241],{"class":80,"line":235},18,[78,237,238],{"class":91},"  \"parallel_processing\"",[78,240,110],{"class":84},[78,242,243],{"class":91},"true\n",[78,245,247],{"class":80,"line":246},19,[78,248,249],{"class":84},"}\n",[16,251,252],{},"Current constraints:",[30,254,255,258,261,264,267,274],{},[33,256,257],{},"minimum 1 video",[33,259,260],{},"maximum 100 videos",[33,262,263],{},"webhook is batch-level",[33,265,266],{},"per-video custom instructions are not part of the current batch request schema",[33,268,269,270,273],{},"the backend emits the batch-level ",[20,271,272],{},"webhook_url"," once all child jobs reach a terminal state",[33,275,276,279,280,283],{},[20,277,278],{},"priority"," and ",[20,281,282],{},"parallel_processing"," are currently accepted fields, but they do not materially change execution behavior in the current backend",[25,285,287],{"id":286},"get-apiv1batchstatusbatch_id",[20,288,42],{},[16,290,291],{},"Returns aggregate progress and the state of each individual job.",[16,293,294],{},"Possible batch statuses:",[30,296,297,302,307,312],{},[33,298,299],{},[20,300,301],{},"processing",[33,303,304],{},[20,305,306],{},"completed",[33,308,309],{},[20,310,311],{},"partial_failure",[33,313,314],{},[20,315,316],{},"failed",[25,318,320],{"id":319},"get-apiv1batchresultsbatch_id",[20,321,47],{},[16,323,324],{},"Returns:",[30,326,327,332,337,342],{},[33,328,329],{},[20,330,331],{},"successful_jobs",[33,333,334],{},[20,335,336],{},"failed_jobs",[33,338,339],{},[20,340,341],{},"summary_stats",[33,343,344],{},"aggregate processing metadata",[16,346,347],{},"Optional query parameter:",[30,349,350],{},[33,351,352],{},[20,353,354],{},"include_failed=true",[25,356,358],{"id":357},"get-apiv1batch",[20,359,52],{},[16,361,362],{},"Lists the authenticated user's batches with pagination metadata.",[364,365,366],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":74,"searchDepth":88,"depth":88,"links":368},[369,370,371,372,373,374],{"id":27,"depth":88,"text":28},{"id":55,"depth":88,"text":56},{"id":62,"depth":88,"text":37},{"id":286,"depth":88,"text":42},{"id":319,"depth":88,"text":47},{"id":357,"depth":88,"text":52},"2025-01-20","Current public batch-processing endpoints",false,"md",null,{},true,"\u002Fapi\u002Fbatch","TechArticle",{"title":5,"description":376},"api\u002Fbatch",[387,388,389],"api","integration","workflows","2026-03-22","huXpc_GuAPHbiHxmwB_EqoNV843tg_RklXvLD01Bc8w",1792448456889]