API Documentation

Name: AutoSizer
Author: AutoSizer

Integrate AutoSizer image processing into your applications with our REST API. Submit public image URLs, poll for results, and download signed output links.

Quick Start

Solo plan required. Keys are shown once at creation time.

1. Get API Key

Generate an ask_ key from the dashboard

2. Submit URLs

POST public image URLs with a supported platform

3. Poll Results

Poll job status every few seconds until completed or failed

Get Your API Key

API Endpoints

Cloud Functions URLs (there is no /api/v1 router on autosizer.xyz)

POST

https://us-central1-autosizer.cloudfunctions.net/apiProcessFunction

Process images from public HTTPS URLs (max 10 per request)

GET

https://us-central1-autosizer.cloudfunctions.net/apiGetJobFunction?jobId={jobId}

Get job status, signed download URLs, optional zipUrl

GET

https://us-central1-autosizer.cloudfunctions.net/apiListJobsFunction

List your jobs (newest first)

GET

https://us-central1-autosizer.cloudfunctions.net/apiGetPlatformsFunction

List supported platforms (etsy, shopify, amazon)

GET

https://us-central1-autosizer.cloudfunctions.net/apiStatusFunction

API liveness check (does not verify processing health)

Code Examples

Example requests for common operations

Process Images

curl -X POST https://us-central1-autosizer.cloudfunctions.net/apiProcessFunction \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      {
        "url": "https://example.com/image.jpg",
        "platform": "etsy"
      }
    ]
  }'

Check Job Status

curl -X GET "https://us-central1-autosizer.cloudfunctions.net/apiGetJobFunction?jobId=YOUR_JOB_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Supported Platforms

curl -X GET https://us-central1-autosizer.cloudfunctions.net/apiGetPlatformsFunction

Response Examples

Sample API responses

Process Response

{
  "success": true,
  "jobId": "1730000000000_abc123",
  "status": "processing",
  "estimatedTime": "30s",
  "images": [
    {
      "id": "img_1",
      "status": "queued",
      "originalUrl": "https://example.com/image.jpg"
    }
  ]
}

Job Status Response

{
  "success": true,
  "jobId": "1730000000000_abc123",
  "status": "completed",
  "createdAt": "2026-08-12T10:30:00.000Z",
  "completedAt": "2026-08-12T10:30:45.000Z",
  "zipUrl": "https://storage.googleapis.com/...",
  "images": [
    {
      "id": "img_main2000",
      "status": "completed",
      "downloadUrl": "https://storage.googleapis.com/...",
      "variant": "main2000",
      "originalSize": "2.3MB",
      "processedSize": "1.1MB",
      "compressionRatio": "52%"
    }
  ]
}