Skip to content
    PricingSign in
    Developer API

    API Documentation

    Integrate InstaLabelRemover into your tools or automated pipelines.

    Quickstart

    1. Subscribe to the Ultimate plan (1,000 API calls/month included).
    2. Create an API key below.
    3. Send a POST request to /api-clean.
    4. Need more calls? Buy a pay-as-you-go pack.

    Your API keys

    Sign in to create API keys.

    Authentication

    All requests require a Bearer token in the Authorization header:

    Authorization: Bearer ilr_live_xxxxxxxxxxxxxxxxxxxxxxxx

    Keys are scoped to your account. Rotate or revoke them anytime from the Quickstart panel above. Never expose them in client-side code.

    Endpoints

    POST/api-clean

    Authenticate, decrement quota and return the recommended iPhone EXIF profile to apply.

    Body (JSON): { model_id?: string } — defaults to 16promax.

    Response 200: { ok, model_id, remaining }

    Errors: 401 invalid_api_key, 403 ultimate_required, 429 quota_exceeded.

    Examples

    cURL

    curl -X POST https://brhniwphzgqyntgpbzzm.supabase.co/functions/v1/api-clean \
  -H "Authorization: Bearer $ILR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"16promax"}'

    JavaScript / TypeScript

    const res = await fetch(
  "https://brhniwphzgqyntgpbzzm.supabase.co/functions/v1/api-clean",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.ILR_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ model_id: "16promax" }),
  }
);
const data = await res.json();
console.log(data.remaining, "calls left");

    Python

    import os, requests
r = requests.post(
    "https://brhniwphzgqyntgpbzzm.supabase.co/functions/v1/api-clean",
    headers={"Authorization": f"Bearer {os.environ['ILR_API_KEY']}"},
    json={"model_id": "16promax"},
)
print(r.json())

    Webhooks

    Webhook delivery for usage events is on the roadmap. For now, poll /api-clean's response field remaining to monitor your quota.

    Rate limits & quotas

    • Ultimate: 1,000 calls/month included. API access is not available with Free or Pro.
    • Pay-as-you-go: top-up packs (1k/10k/50k) added to the same monthly bucket.
    • Quotas reset on the 1st of each month (UTC).

    Changelog

    • v1.0 — initial public API release: /api-clean, key management, pay-as-you-go packs.