/image namespace · APlicious

Image Metadata API — dimensions, dominant color, and format analysis

The /image namespace analyzes uploaded files or remote URLs for dimensions, format, color space, dominant color, and quality metrics — accepts both multipart upload and a JSON URL body.

3image endpoints

Get free API key View docs

POST /api/v1/image/analyze

const res = await fetch('https://aplicious.com/api/v1/image/analyze', {
  method: 'POST',
  headers: { 'X-API-Key': 'lapi_live_••••', 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://picsum.photos/200' }),
});
const { data } = await res.json();
// { width: 200, height: 200, format: "jpeg", dominant_color: { hex: "#8a7b6c" } }

No credit card · Free tier forever · X-API-Key header auth

What's included in /image

Dual input modes

Accepts either a multipart/form-data file upload or a JSON body with a remote image URL — same endpoint, no separate routes.

Dominant color extraction

Returns the dominant color as RGB and hex, useful for generating matching UI accents from a user-uploaded image.

Quality and entropy metrics

Sharpness and entropy scores give a rough automated read on image quality.

Format and color space detection

Identifies format, color space, channel count, and alpha presence.

One key, every namespace

Pair image analysis with /color for a complete image-to-palette pipeline.

Start using the image metadata API today

Free tier — 500 calls/month, no credit card. Upgrade when you need more.

Get free API key Explore /image docs

Frequently asked questions

Can I upload a file directly?

Yes — send multipart/form-data with a 'file' field instead of JSON with a URL.

Does it detect NSGW/unsafe content?

Check the current docs for the specific moderation endpoints available in this namespace.

What image formats are supported?

Standard web formats — JPEG, PNG, WebP, GIF, and more via the underlying Sharp image library.

Related API guides

One key unlocks all 34 namespaces — weather, finance, fitness, astrology, and more.

View all plans and pricing →