The DesiBrolls API
Give your editor or AI agent Indian B-roll that matches what the narration means, in English, Hinglish or Hindi.
Search
GET /api/v1/search: clips for a query, ranked by visible match and meaning.
Match narration
POST /api/v1/broll/match: clips for one spoken line, plus what's missing.
Clips & topics
GET /api/v1/clips/:id, /topics, /usage.
Get a key
Sign in with Google to create up to 3 keys yourself. Every account gets free API credits each month (1 credit = 1 call); need more? Tell us. Send it as Authorization: Bearer dbk_…. Keep it on your server, never in a browser or app bundle.
Examples
curl -s "https://desibrolls.com/api/v1/search?q=chai+at+a+roadside+stall&k=3" \ -H "Authorization: Bearer $DESIBROLLS_KEY"
curl -s -X POST "https://desibrolls.com/api/v1/broll/match" \
-H "Authorization: Bearer $DESIBROLLS_KEY" -H "content-type: application/json" \
-d '{"narration": "Raat ko padhai karte karte neend aa jaati hai", "k": 3}'What you get back
Each result has asset_id, title, score (0 to 1), literal (does it show the thing itself), reasons, and links: preview_url, poster_url, page_url, download_url, plus size, length and topics. Only public, rights-cleared clips are ever returned.
Limits
- 120 requests a minute per key (HTTP 429 with
retry-afterbeyond that). - Keys you create in your account spend credits: 1 per call. The
x-credits-remainingheader shows what's left; at zero you get HTTP 402out_of_credits. - Keys we issue for partners have a monthly quota instead (
x-quota-used/x-quota-limit). - Errors are JSON:
{"error": {"code", "message", "docs"}}.
For AI agents
OpenAPI 3.1: /api/v1/openapi.json.
Licence
Clips found through the API follow the DesiBrolls license. Please don't bulk-download the library or use clips to train AI models.