Built for agents, not just browsers.

Payload

POST /your-endpoint
X-Brollvia-Event: download.created
X-Brollvia-Delivery: 1234
X-Brollvia-Signature: sha256=9f86d0…

{
  "event": "download.created",
  "created_at": "2026-01-15T10:30:00Z",
  "data": {
    "asset_id": 42,
    "asset_title": "Rainy Tokyo alley",
    "licence_code": "BV-2026-XXXXXX",
    "plan": "Pro"
  }
}

Verify the signature (PHP)

$secret = "whsec_…"; // shown once when you add the webhook
$body = file_get_contents("php://input");
$expected = "sha256=" . hash_hmac("sha256", $body, $secret);
if (!hash_equals($expected, $_SERVER["HTTP_X_BROLLVIA_SIGNATURE"] ?? "")) {
    http_response_code(401); exit;
}
$event = json_decode($body, true);

cURL

curl "https://brollvia.com/api/v1/search?q=rainy+tokyo+alley+at+night&type=video" \
  -H "Authorization: Bearer bv_live_YOUR_KEY"

PHP

$ch = curl_init("https://brollvia.com/api/v1/search?q=ocean&type=video");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer bv_live_YOUR_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
foreach ($data["data"] as $asset) echo $asset["title"], "\n";

JavaScript

const res = await fetch("https://brollvia.com/api/v1/search?q=ocean&type=video", {
  headers: { Authorization: "Bearer bv_live_YOUR_KEY" },
});
const { data, meta } = await res.json();

Python

import requests
r = requests.get("https://brollvia.com/api/v1/search",
                 params={"q": "ocean", "type": "video"},
                 headers={"Authorization": "Bearer bv_live_YOUR_KEY"})
for asset in r.json()["data"]:
    print(asset["id"], asset["title"])

ChatGPT

1. Settings → Connectors → Add custom MCP server, name it Brollvia.
2. Server URL: https://brollvia.com/mcp
3. Authentication: OAuth — ChatGPT discovers our OAuth endpoints automatically and sends you here to sign in and approve. No key to paste.

Claude

1. Settings → Connectors → Add custom connector.
2. Remote MCP server URL: https://brollvia.com/mcp
3. Connect with OAuth — you'll approve the requested scopes on this site, and can revoke any time under Connected apps in your Developer settings.

Cursor / Claude Code (API key)

{
  "mcpServers": {
    "brollvia": {
      "url": "https://brollvia.com/mcp",
      "headers": { "Authorization": "Bearer bv_live_YOUR_KEY" }
    }
  }
}

Copy config

Config-file clients send a static header, so they use an API key. Your account page generates this config with a fresh key filled in.

OAuth 2.1 endpoints

Protected resource metadata: https://brollvia.com/.well-known/oauth-protected-resourceCopy
Authorization server metadata: https://brollvia.com/.well-known/oauth-authorization-serverCopy
Dynamic client registration: POST https://brollvia.com/oauth/register · Authorize: https://brollvia.com/oauth/authorize · Token: POST https://brollvia.com/oauth/token

Authorization code flow with PKCE (S256) is required; access tokens are opaque, expire after 1 hour, and refresh tokens rotate (reuse revokes the chain). Scopes: read, download, collections:write.

Tools the model can call

search_assets get_asset find_similar list_collections get_collection create_shotlist add_to_shotlist download_asset get_licence suggest_broll_for_script Pro get_trending list_topics

Scopes gate tools just like endpoints; plan gating is identical to the web — a Free account can search everything but downloads follow Free rules, and suggest_broll_for_script needs Pro. Every call is audit-logged against the credential (key or connected app) and visible in your Developer page usage.

JavaScript — brollvia.mjs (ESM, Node 18+)

import { BrollviaClient } from "./brollvia.mjs";

const bv = new BrollviaClient({
  baseUrl: "https://brollvia.com",
  apiKey: "bv_live_YOUR_KEY",
});

const { assets } = await bv.search({ q: "ocean at dawn", type: "video" });
const saved = await bv.download(assets[0].id, { to: "./shot.mp4" });
console.log(saved.path, saved.licence.code); // licence record included

Python — stdlib only (urllib)

from brollvia import BrollviaClient

bv = BrollviaClient(base_url="https://brollvia.com",
                    api_key="bv_live_YOUR_KEY")

res = bv.search(q="ocean at dawn", type="video")
saved = bv.download(res["assets"][0]["id"], to="./shot.mp4")
print(saved["path"], saved["licence"]["code"])