Skip to main content
ScreenScore AI gives you structured, AI-generated scores for any visual content — UI screens, ad creatives, or landing pages — through a simple REST API. This guide walks you through everything you need to go from zero to your first analysis result.
1

Create your account

Sign up at screenscoreai.com and verify your email address. Once your account is active, you’ll land on the ScreenScore AI dashboard.
2

Generate an API key

In your dashboard, navigate to Settings → API Keys and click Create new key. Give it a descriptive name (for example, development or production) so you can identify it later.
Copy your API key immediately after creating it — it won’t be shown again. Store it in a secrets manager or environment variable, never in source code. See Authentication for more on securing your credentials.
3

Submit your first analysis

Send a POST request to /v1/analyses with the URL of the image you want to analyze. Include your API key as a Bearer token in the Authorization header.
curl -X POST https://api.screenscoreai.com/v1/analyses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj_YOUR_PROJECT_ID",
    "image_url": "https://example.com/screenshot.png"
  }'
4

View your results

A successful request returns a JSON object with the analysis ID, overall score, and a breakdown across each scoring dimension.
{
  "id": "ana_01j9k2m4p6q8r0s2t4u6v8w0",
  "status": "completed",
  "score": 74,
  "breakdown": {
    "visual_clarity": 81,
    "visual_hierarchy": 76,
    "color_and_contrast": 70,
    "cta_effectiveness": 65,
    "brand_consistency": 79
  },
  "created_at": "2026-04-16T10:32:00Z"
}
You can also view results directly in the Analyses section of your dashboard, where scores are displayed with visual indicators and improvement suggestions.
Scores range from 0 to 100. A score above 70 is considered excellent. See How ScreenScore AI analyzes your content to understand what each dimension measures.