PiiBlur
Face Blur API

Face Blur API

Blur faces in photos and videos with an asynchronous REST API. Upload media, select the heads category, and download the redacted output when processing completes.

Start FreeRead API Docs

How do I blur faces with an API?

  1. 1Create a PiiBlur API key from your dashboard.
  2. 2Upload an image or video to /api/v1/media/redact with categories[]=heads.
  3. 3Poll the media status or use webhooks, then download the completed redacted file.

Compliance note

PiiBlur supports visual redaction workflows and can help reduce exposure as one step in a broader privacy or compliance program. It does not certify GDPR, CCPA, FERPA, HIPAA, SOC 2, CJIS, FOIA, or medical compliance. Consult legal or compliance counsel for your specific obligations.

How to call the face blur API

Use multipart uploads for images and videos. Redaction jobs are asynchronous, so production workflows should poll the media endpoint or listen for webhook events.

bash
curl -X POST https://piiblur.com/api/v1/media/redact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "categories[]=heads" \
  -F "redaction_method=blur"
Full API referencePricing and free tier

Supported formats

JPGJPEGPNGWebPMP4MOVWebM

Supported categories

  • Heads
  • License plates
  • Screens
  • Writing
  • Documents

Common API workflows

Property listing photos with bystanders
Dashcam footage with pedestrians
Campus and event photography
Newsroom and public-release workflows

Related guides

How to Blur Faces in Photos AutomaticallyHow to Redact PII from Videos

Frequently asked questions

Can the API blur faces in video?

Yes. PiiBlur processes MP4, MOV, and WebM videos up to 10 minutes per file, tracking detected heads across frames.

Can I use pixelation instead of blur?

Yes. Set redaction_method to pixelation when creating the redaction job.

Does face blurring require manual selection?

No. The heads category is detected automatically. You should still review outputs before publishing high-risk media.

Add automated PII redaction to your workflow

Start with the free tier, review the API contract, and scale when your media volume grows.

Start FreeSee Pricing