Skip to content

API Reference

BriefBlip's endpoints are plain HTTP/JSON, served from api.briefblip.com. Every endpoint that isn't purely read-only accepts anonymous requests under a rate limit — there's no signup or API key required to try it.

Base URL

https://api.briefblip.com

Auth & lifting the rate limit

Every write-ish endpoint (meeting extraction, transcription, doc/URL blips) works anonymously, rate-limited by network address. If you're integrating BriefBlip into something and the anonymous limit is too low, send a X-Briefblip-Key header with a key issued by Blue Note Logic:

X-Briefblip-Key: <your key>

A valid key lifts the endpoint's normal rate limit entirely. There's no self-service key issuance today — contact Blue Note Logic to get one.

Rate limits at a glance

Endpoint Anonymous limit
extract.php (meeting extraction) 20 / hour per network
transcribe.php (audio transcription) 10 / hour per network
blip.php (doc/URL blip) 10 / hour and 30 / day per network
subscribe.php (weekly signup) 10 / hour per network, 3 / day per address
view.php, weekly.php, sitemap.php none — fully public

A rate-limited request returns HTTP 429 with a JSON body explaining which limit was hit.

Error shape

Every endpoint that can fail returns a JSON body of the form:

{ "error": "<human-readable message>" }

alongside a status code appropriate to the failure — see each endpoint page for the specific codes it uses.

Endpoints by flow