BlurFaces API

Programmatic face blurring for photos and videos. Built for privacy-compliance workflows at scale. Authenticate with a bearer key, POST your media, get a blurred response — no face data is retained.

Pricing & Plans

API access is included with paid plans. Your subscription tier determines your daily call limit:

Authentication

Every request carries a bearer API key in the Authorization header:

Authorization: Bearer bf_yourApiKeyHere

Get an API Key

POST /api/v1/keys

curl -X POST https://blurfaces.org/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "name": "Production"}'

Response:

{"id": "...", "key": "bf_...", "name": "Production", "rateLimit": 100}

Blur a Photo

POST /api/v1/blur/photo

curl -X POST https://blurfaces.org/api/v1/blur/photo \
  -H "Authorization: Bearer bf_yourKey" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  -o blurred.jpg

Returns the blurred image with the same content type, or a JSON error.

Blur a Video

POST /api/v1/blur/video — creates an async blur job. Uses the same pipeline as the web app.

curl -X POST https://blurfaces.org/api/v1/blur/video \
  -H "Authorization: Bearer bf_yourKey" \
  -H "Content-Type: video/mp4" \
  --data-binary @video.mp4

Rate Limits

Rate limit headers are returned on every response: X-RateLimit-Remaining, X-RateLimit-Limit. Exceeding your daily quota returns a 429 response until the counter resets at UTC midnight.

Use Cases

Real estate listings, content moderation, GDPR compliance, school photography, social media tools, HR document processing. A single enterprise customer doing 100K photos/month pays ~$5,000/month at standard rates.

Popular use cases

• Parents sharing family photos
• Teachers and classroom updates
• Real estate listing privacy
• Auto dealership inventory photos
• Content creators on TikTok, Reels, and YouTube
• HR and internal comms teams