Skip to main content
POST
/
v2
/
thumbnail
/
score
cURL
curl -X POST "https://api.pikzels.com/v2/thumbnail/score" \
  -H "X-Api-Key: pkz_yourapikey" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "image_url": "https://cdn.pikzels.com/example.png"
}'
{
  "main_score": 84,
  "request_id": "18b2ad5e-2a9e-4d3f-b9a8-9f2a1e0b1234",
  "subscores": {
    "clarity": 82,
    "curiosity": 85,
    "emotion": 76,
    "idea": 79,
    "virality": 88
  },
  "suggestion": "Increase contrast and tighten composition in the center section."
}

Authorizations

X-Api-Key
string
header
required

Your Pikzels API key (prefix: pkz_)

Body

application/json
image_url
string
required

HTTPS URL -- provide this or image_base64

Pattern: ^https://\S+$
image_base64
string

Base64 data URL -- provide this or image_url

Pattern: ^data:image/[a-zA-Z0-9.+-]+;base64,
title
string

Optional title for context

Maximum string length: 200

Response

Success

main_score
number
required

Overall score 0-100

request_id
string
required
subscores
object
required
suggestion
string | null
required