[{"data":1,"prerenderedAt":235},["ShallowReactive",2],{"doc-api\u002Fusage":3},{"id":4,"title":5,"author":6,"body":7,"date":218,"description":219,"draft":220,"extension":221,"faq":222,"meta":223,"navigation":224,"path":225,"schemaType":226,"seo":227,"stem":228,"tags":229,"updatedAt":233,"__hash__":234},"content\u002Fapi\u002Fusage.md","Usage","YT2Text Team",{"type":8,"value":9,"toc":208},"minimark",[10,15,24,29,32,36,60,65,68,90,95,98,120,123,140,145,148,175,180,183,199],[11,12,14],"h1",{"id":13},"usage-api","Usage API",[16,17,18,19,23],"p",{},"Usage endpoints live under ",[20,21,22],"code",{},"\u002Fapi\u002Fv1\u002Fusage",".",[25,26,28],"h2",{"id":27},"important-note","Important Note",[16,30,31],{},"These endpoints expose current quota counters and persisted processing-job analytics where available. They are useful for integrations and diagnostics, but billing and quota enforcement remain the source of truth for invoicing and access decisions.",[25,33,35],{"id":34},"endpoints","Endpoints",[37,38,39,45,50,55],"ul",{},[40,41,42],"li",{},[20,43,44],{},"GET \u002Fapi\u002Fv1\u002Fusage\u002Fcurrent",[40,46,47],{},[20,48,49],{},"GET \u002Fapi\u002Fv1\u002Fusage\u002Fhistory",[40,51,52],{},[20,53,54],{},"GET \u002Fapi\u002Fv1\u002Fusage\u002Fanalytics",[40,56,57],{},[20,58,59],{},"GET \u002Fapi\u002Fv1\u002Fusage\u002Flimits",[25,61,63],{"id":62},"get-apiv1usagecurrent",[20,64,44],{},[16,66,67],{},"Returns a current-period payload with:",[37,69,70,75,80,85],{},[40,71,72],{},[20,73,74],{},"current_period",[40,76,77],{},[20,78,79],{},"rate_limits",[40,81,82],{},[20,83,84],{},"endpoint_breakdown",[40,86,87],{},[20,88,89],{},"cost_projection",[25,91,93],{"id":92},"get-apiv1usagehistory",[20,94,49],{},[16,96,97],{},"Query params:",[37,99,100,105,110,115],{},[40,101,102],{},[20,103,104],{},"start_date",[40,106,107],{},[20,108,109],{},"end_date",[40,111,112],{},[20,113,114],{},"granularity",[40,116,117],{},[20,118,119],{},"limit",[16,121,122],{},"Returns:",[37,124,125,130,135],{},[40,126,127],{},[20,128,129],{},"periods",[40,131,132],{},[20,133,134],{},"summary",[40,136,137],{},[20,138,139],{},"query_info",[25,141,143],{"id":142},"get-apiv1usageanalytics",[20,144,54],{},[16,146,147],{},"Returns persisted-job analytics sections like:",[37,149,150,155,160,165,170],{},[40,151,152],{},[20,153,154],{},"trends",[40,156,157],{},[20,158,159],{},"patterns",[40,161,162],{},[20,163,164],{},"predictions",[40,166,167],{},[20,168,169],{},"optimization_suggestions",[40,171,172],{},[20,173,174],{},"top_endpoints",[25,176,178],{"id":177},"get-apiv1usagelimits",[20,179,59],{},[16,181,182],{},"Returns the current rate-limit view with:",[37,184,185,189,194],{},[40,186,187],{},[20,188,79],{},[40,190,191],{},[20,192,193],{},"warnings",[40,195,196],{},[20,197,198],{},"recommendations",[16,200,201,202,207],{},"For actual enforced request throttling and plan quotas, use the ",[203,204,206],"a",{"href":205},"\u002Freference\u002Frate-limits","Rate Limits"," reference.",{"title":209,"searchDepth":210,"depth":210,"links":211},"",2,[212,213,214,215,216,217],{"id":27,"depth":210,"text":28},{"id":34,"depth":210,"text":35},{"id":62,"depth":210,"text":44},{"id":92,"depth":210,"text":49},{"id":142,"depth":210,"text":54},{"id":177,"depth":210,"text":59},"2025-01-20","Current public usage and diagnostics endpoints",false,"md",null,{},true,"\u002Fapi\u002Fusage","TechArticle",{"title":5,"description":219},"api\u002Fusage",[230,231,232],"api","integration","workflows","2026-03-22","2uh5648T7X1f8oInIrNBRPPMo7yd9feVthXzdOklFmE",1792448456891]