{"openapi":"3.1.0","info":{"title":"DesiBrolls API","version":"1.0.0","description":"Search and match authentic Indian B-roll (AI-generated, hand-reviewed) by meaning, in English, Hinglish or Hindi."},"servers":[{"url":"https://desibrolls.com/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Clip":{"type":"object","properties":{"asset_id":{"type":"string"},"title":{"type":"string"},"score":{"type":"number"},"literal":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"preview_url":{"type":"string"},"poster_url":{"type":"string"},"page_url":{"type":"string"},"download_url":{"type":"string"},"duration_s":{"type":"number"},"orientation":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"category":{"type":"string"},"topics":{"type":"array","items":{"type":"string"}}}},"Filters":{"type":"object","properties":{"category":{"type":"string"},"topic":{"type":"string"},"orientation":{"type":"string","enum":["vertical","horizontal","square"]},"style":{"type":"string","enum":["close-up","process","faceless","animal","scenery","people"]},"max_duration":{"type":"number"}}}}},"security":[{"bearer":[]}],"paths":{"/search":{"get":{"summary":"Search clips","parameters":[{"name":"q","in":"query","required":true,"description":"What you need, e.g. 'chai at a roadside stall' or 'padhai late night'","schema":{"type":"string"}},{"name":"k","in":"query","required":false,"description":"Results (1-50, default 12)","schema":{"type":"integer"}},{"name":"category","in":"query","required":false,"description":"Category slug","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Topic id from /topics","schema":{"type":"string"}},{"name":"orientation","in":"query","required":false,"description":"vertical | horizontal | square","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"close-up | process | faceless | animal | scenery | people","schema":{"type":"string"}}],"responses":{"200":{"description":"Ranked clips","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/Clip"}},"no_match":{"type":"boolean"}}}}}}}}},"/broll/match":{"post":{"summary":"Match B-roll to a narration line","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["narration"],"properties":{"narration":{"type":"string"},"k":{"type":"integer","default":5},"prefer":{"type":"string","enum":["literal","any"]},"min":{"type":"number"},"filters":{"$ref":"#/components/schemas/Filters"}}}}}},"responses":{"200":{"description":"Ranked clips plus missing_inventory ideas when nothing fits"}}}},"/clips/{id}":{"get":{"summary":"One clip","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Clip"},"404":{"description":"Not found"}}}},"/topics":{"get":{"summary":"Topics with public clips","responses":{"200":{"description":"Topics"}}}},"/usage":{"get":{"summary":"This key's usage this month","responses":{"200":{"description":"Usage"}}}}}}