API Documentation

Build powerful applications with our streamlined API. Easy to use, fully-featured, and secure.

Getting Started

Create Account

Get your API key and start building in minutes. No credit card required for the free tier.

Quick Start

Follow these steps to make your first API request with Node.js or Python.


// Node.js Example
const response = await fetch('https://api.easyma.com/data', {
  headers: {
    'Authorization': `Bearer YOUR_API_KEY`
  }
});

API Endpoints

All requests must be made with Authorization: Bearer YOUR_API_KEY

GET /data

Retrieve processed data based on filters

Public Read

200 OK


{
  "status": "success",
  "data": {
    "metrics": { /* processed data here */ }
  }
}

POST /process

Submit raw data for processing

Private Write

202 Accepted


{
  "request_id": "abc123",
  "estimated_complete": "2025-09-14T12:30:00Z"
}

Code Examples


// Python Example
import requests

url = "https://api.easyma.com/process"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "raw_input": "your_base64_encoded_data"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Troubleshooting

How to handle rate limits?

We implement sliding window rate limiting. You'll receive a 429 Too Many Requests with a Retry-After header indicating seconds until reset.

How to get support for errors?

All errors include an error_code field and support_link URL. You can also contact our support team via contact form.