removr API

Remove watermarks, logos, text, and timestamps programmatically with the same no-blur engine as the app. Each batch supports up to 50 images and uses 1 account credit per image. Failed images are refunded.

Authenticate requests

Create a key under Account settings → API access. The key is shown only once, so copy it immediately. Include it as a Bearer token with every request:

Authorization: Bearer rmvr_live_xxxxxxxxxxxxxxxx

Base URL: https://removr.pro. Keep your keys private because they can use your credits.

Quick start

Submit images, poll the job, then download the cleaned results.

# 1) Submit 1–50 images (multipart field: "files")
curl -X POST https://removr.pro/api/v1/remove \
  -H "Authorization: Bearer $REMOVR_KEY" \
  -F "files=@photo.jpg"
# → { "jobId": "a1b2...", "count": 1, "status": "processing" }

# 2) Poll the job until status = "done"
curl https://removr.pro/api/v1/jobs/a1b2... \
  -H "Authorization: Bearer $REMOVR_KEY"
# → { "status": "done", "images": [
#      { "id": "photo-0", "ok": true, "url": "https://removr.pro/api/v1/files/.../photo-0-clean.jpg" } ] }

# 3) Download each cleaned image using the same Authorization header
curl -L https://removr.pro/api/v1/files/.../photo-0-clean.jpg \
  -H "Authorization: Bearer $REMOVR_KEY" -o clean.jpg

API endpoints

POST /api/v1/remove

Submit images for watermark removal as multipart/form-data in the files field. Send 1–50 JPG, PNG, or WEBP files of up to 25 MB each. Use the optional Idempotency-Key header for safe retries. One credit per image is deducted when submitted.

{ "jobId": "a1b2c3...", "count": 3, "status": "processing" }

GET /api/v1/jobs/:jobId

Poll the job until status changes from processing to done. Each completed image returns ok:true with a url, or ok:false with an error. Credits for failed images are refunded.

{
  "id": "a1b2c3...",
  "status": "done",
  "total": 3,
  "images": [
    { "id": "a-0", "ok": true,  "url": "https://removr.pro/api/v1/files/a1b2c3.../a-0-clean.jpg" },
    { "id": "b-1", "ok": false, "error": "could not process" }
  ]
}

GET /api/v1/files/:jobId/:name

Download a cleaned image using the same Bearer key. The response contains the image bytes.

Credits and limits

• Each image uses 1 credit. The API and web app share the credit balance included with your plan.
• Failed images are refunded automatically. Credits are charged only for cleaned results.
• Each request supports up to 50 images of 25 MB each in JPG, PNG, or WEBP format.
• Only process images you own or are licensed to edit.

Errors