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

Rate Limits

Free Plan100 req/hour

Pro Plan1,000 req/hour

Enterprise10,000 req/hour

SDKs & Libraries

JavaScript/Node.js Python PHP cURL 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