API Documentation

ImgNodus provides a powerful, REST-based API for developers to programmatically manage and optimize their image assets. Our infrastructure is built for speed, scale, and ease of use.

Netlify & Frontend Integration

ImgNodus is fully compatible with static sites (Next.js, Vite, Astro) and SPAs hosted on platforms like Netlify or Vercel.

Environment Variables

To keep your API key secure, always store it in Netlify's environment variables. In your Netlify dashboard, go to Site Settings > Build & Deploy > Environment and add:

IMGNODUS_API_KEY = your_key_here

Sample: Fetch in React/Netlify Function

async function uploadToImgNodus(file) {
    const formData = new FormData();
    formData.append('file', file);

    const response = await fetch('https://api.imgnodus.com/v1/upload', {
        method: 'POST',
        headers: {
            // Securely access via process.env in build or functions
            'Authorization': `Bearer ${process.env.IMGNODUS_API_KEY}`
        },
        body: formData
    });
    return await response.json();
}Copy

Authentication

Authenticate your requests by including your secret API key in the Authorization header.

Your API key can be found in the Developer Dashboard.

Authorization: Bearer rzp_live_xxxxxxxxxxxxxxxxCopy

[!WARNING] Never share your API key in client-side code (except when using our secure React SDK). Always use environment variables in your backend.

Upload Image

POST /v1/upload

Upload a raw image file. The engine will automatically convert it to WebP and return a secure CDN URL.

Parameters

const res = await fetch('https://api.imgnodus.com/v1/upload', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_KEY' },
    body: formData
});Copy

Image Optimization

ImgNodus automatically converts all uploads to WebP unless specified otherwise. This reduces file size by an average of 82% compared to JPEG while preserving visual fidelity.