{"uid":"cap_U27Xf4bjXCa2r6ZPjG1qw","slug":"smpte-timecode-parser-dbd0479e","name":"SMPTE Timecode Parser","description":"Parse an SMPTE timecode (HH:MM:SS:FF, or HH:MM:SS;FF for drop-frame) at a given frame rate into its components, total frame count and real-time seconds. Drop-frame is auto-detected from a ';' separator unless dropFrame is set. Out-of-range or non-existent drop-frame values are a clean 400.","url":"https://timecode.openverbs.com/v1/parse","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["timecode","frameRate"],"properties":{"timecode":{"type":"string","maxLength":20,"minLength":1,"description":"Timecode, e.g. 01:00:00:00 or 00:01:00;02."},"dropFrame":{"type":"boolean","description":"Force drop-frame counting (29.97/59.94 only). Default: auto-detect from separator."},"frameRate":{"enum":[24,25,30,48,50,60,23.976,29.97,47.952,59.94],"type":"number","description":"Frame rate, e.g. 24, 25, 29.97, 30, 59.94, 60."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Hq3Vjmz8mp7QaTv9KHEZS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses an SMPTE timecode string at a given frame rate into its components, total frame count, and real-time seconds, with automatic drop-frame detection.","exampleAgentPrompt":"Parse the timecode 01:23:45;12 at 29.97 fps — it's drop-frame — and tell me the total frame count and how many real-time seconds that is.","exampleUseCases":[{"title":"Validate broadcast timecode accuracy","prompt":"I have the timecode 00:59:59;29 at 29.97 fps drop-frame — can you parse it and confirm whether it's a valid timecode and tell me the exact real-time seconds it represents?"},{"title":"Convert edit point to frame count","prompt":"My video editor is at timecode 02:14:33:10 at 24fps. Can you break that down into hours, minutes, seconds, and frames, and give me the total absolute frame number from the start?"},{"title":"Sync audio to video via real-time offset","prompt":"I need to know how many real-time seconds in is the timecode 00:00:45:00 at 25fps so I can align my audio track to the right spot in the video."}],"resultDescription":"Returns the parsed components of the timecode (hours, minutes, seconds, frames), the total frame count from 00:00:00:00, and the equivalent real-time duration in seconds. Returns a 400 error for out-of-range values or invalid drop-frame timecodes.","failureModes":["400 if timecode components are out of range (e.g. frames exceed frame rate)","400 if a drop-frame timecode refers to a non-existent frame (e.g. dropped frames at minute boundaries)","400 if frame rate is not one of the supported enum values","400 if timecode string is malformed or exceeds length limits","400 if dropFrame=true is set for a non-drop-frame-compatible frame rate (e.g. 24fps)"],"whenToPreferThis":"Use this endpoint when you need to decompose a raw SMPTE timecode string into its numeric parts, get the absolute frame count, or convert a timecode to real-time seconds. It is the right choice when drop-frame auto-detection (via the ';' separator) or explicit drop-frame mode is needed, and when input validation with clean error responses matters. Prefer the sibling arithmetic endpoint for adding/subtracting timecodes, or the rebase endpoint for frame-rate conversion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:36:27.533Z","isFirstParty":false}