---
title: Score Image Quality API
slug: score-image-aesthetic-quality
url: https://apyhub.com/dosvak/service/score-image-aesthetic-quality
provider: Dosvak LLC
categories: [Artificial Intelligence, Image Processing]
tags: [image-quality, composition-analysis, photo-scoring, visual-quality, image-processing]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 100
---

# Score Image Quality API

Score uploaded images for composition and visual quality. Returns an overall score, face count, and metrics for colour, thirds, and sharpness.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/dosvak/score-image-aesthetic-quality` | What it does Scores an uploaded image for composition and visual quality. It accepts one image file… | 100 |

## Endpoint reference

### Score image composition and visual quality

`POST https://api.eu.apyhub.com/dosvak/score-image-aesthetic-quality` · 100 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Image file |

#### Quickstart

Upload an image to score its aesthetic quality.

```bash
curl -X POST "https://api.eu.apyhub.com/dosvak/score-image-aesthetic-quality" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"
```

#### What you'll get back

Returns a JSON object with numeric scoring fields such as `score`, `face_count`, `color_score`, `thirds_score`, `exposure_score`, and `sharpness_score`, plus `suggestions` as an array of strings.

```json
{
  "score": 0.82,
  "face_count": 1,
  "color_score": 0.77,
  "suggestions": ["Improve lighting", "Try a tighter crop"],
  "thirds_score": 0.74,
  "exposure_score": 0.8,
  "sharpness_score": 0.79
}
```

## About

## What it does
Image Quality Scorer analyzes an uploaded image and returns a composition and visual-quality breakdown. Send a binary image file up to 20 MB, and get back an overall `score` plus component metrics that help you understand what is driving the result.

The response includes `face_count`, `color_score`, `thirds_score`, `exposure_score`, `sharpness_score`, and a `suggestions` array of strings. That makes it useful when you need to rank user-submitted photos, filter low-quality images before moderation or review, or give photographers and creators quick feedback on framing, lighting, and focus.

Use it anywhere image quality matters but a human review would be too slow or inconsistent. For example, you can sort marketplace listings by image quality, reject blurry uploads before they hit storage, or score candidate thumbnails before choosing the best one for a campaign.

Image Quality Scorer returns simple numeric signals you can compare, threshold, or combine with your own business rules.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/score-image-aesthetic-quality