API Documentation

Integrate AutoSizer's powerful image processing capabilities into your applications with our REST API. Process images, manage jobs, and access results programmatically.

Quick Start

Get up and running with the AutoSizer API in minutes

1. Get API Key

2. Make Request

Send images to our processing endpoint

3. Get Results

Retrieve processed images and job status

Get Your API Key

API Endpoints

Complete reference for all available API endpoints

POST

/api/v1/process

Process and optimize images

GET

/api/v1/jobs/{jobId}

Get job status and results

GET

/api/v1/jobs

List user jobs

GET

/api/v1/platforms

Get supported platforms

GET

/api/v1/status

Check service status

Code Examples

Example requests and responses 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",
        "options": {
          "width": 1000,
          "height": 1000,
          "format": "jpeg",
          "quality": 90
        }
      }
    ]
  }'

Check Job Status

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

Get Supported Platforms

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

Response Examples

Sample API responses for different operations

Process Response

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

Job Status Response

{
  "success": true,
  "jobId": "job_123456",
  "status": "completed",
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:30:45Z",
  "images": [
    {
      "id": "img_1",
      "status": "completed",
      "downloadUrl": "https://cdn.autosizer.xyz/processed/img_1.jpg",
      "originalSize": "2.3MB",
      "processedSize": "1.1MB",
      "compressionRatio": "52%"
    }
  ]
}

Authentication

All API requests require authentication using your API key.

Authorization: Bearer YOUR_API_KEY

Get API Key

Usage

Plan requiredSolo ($2/mo)

Images per requestUp to 10

Active keys per accountUp to 5

Examples

Use the cURL examples in the Code Examples section. Pass your API key in the Authorization header.

View code examples

Need Help?

Contact Support Documentation

Ready to Start Building?

Get your API key and start integrating AutoSizer into your applications today.

Get API Key View Pricing