Seasonal Color Analysis – Quiz API | DOC

Introduction

The Seasonal Color Analysis – QUIZ API is designed for beauty, fashion, and styling-related platforms that want to deliver personalized recommendations based on a user’s natural features. By understanding a user’s seasonal color type, brands and retailers can enhance engagement and offer highly personalized beauty and fashion suggestions.

This quiz has already helped countless users in our applications discover their best colors, improving makeup choices, fashion decisions, and overall confidence.

Overview

The Seasonal Color Analysis – QUIZ API analyzes a person’s hair, eye, and skin characteristics to determine their Seasonal Color Type (e.g., Warm Spring, Soft Summer or Deep Winter).

Seasonal Color Analysis is a method used to determine the most flattering color palette for an individual based on their natural features—skin tone, hair color, and eye color. By categorizing people into seasonal types, this analysis helps identify colors that harmonize best with their unique attributes. The right colors can enhance natural beauty, create a balanced look, and complement fashion trends.

Why Use This API?

Enhance user experience – Help customers find their perfect colors for makeup, outfits, and accessories.
Increase conversionsPersonalized recommendations lead to higher engagement and more sales.
Proven & trusted – The Quiz has already been completed by countless real users in our high-rated apps.
 

Who Can Benefit?

– Beauty brands & retailers
– Makeup & skincare platforms
– Fashion & clothing stores
– Jewelry & accessories brands

– Personal styling platforms

Unlock the power of Seasonal Color Analysis to enhance user experience and boost conversions!

REQUEST FORMAT

The request body should be sent in JSON format.

Example Request 

{
    "hairColor": 4,
    "eyeColor": 4,
    "skinColor": 3,
    "hairParam0": true,
    "hairParam1": false,
    "hairParam2": false,
    "eyeParam0": true,
    "eyeParam1": true,
    "eyeParam2": false,
    "eyeParam3": false,
    "eyeParam4": false,
    "eyeParam5": true,
    "eyeParam6": true,
    "eyeParam7": false,
    "eyeParam8": false,
    "eyeParam9": false,
    "skinParam0": false,
    "skinParam1": true,
    "skinParam2": false,
    "skinParam3": false,
    "skinParam4": false,
    "skinParam5": true,
    "skinParam6": false,
    "skinParam7": true,
    "skinParam8": false,
    "skinParam9": true
}


Request Parameters

Parameter Type Description
hairColor Integer Hair color index (0-8). Refer to Hair Colors.
eyeColor Integer Eye color index (0-9). Refer to Eye Colors.
skinColor Integer Skin color index (0-6). Refer to Skin Colors.
hairParamX Boolean Additional hair properties. Refer to Hair Additional Parameters section.
eyeParamX Boolean Additional eye properties. Refer to Eye Additional Parameters section.
skinParamX Boolean Additional skin properties. Refer to Skin Additional Parameters section.

Note: Replace X with the respective parameter index (e.g., hairParam0, eyeParam1).


RESPONSE FORMAT

The API responds with a JSON object containing the calculated seasonal type.

Example Response

{
    "resultSeason": 7
}


Response Parameters

  • resultSeason: Integer. Represents the seasonal type (0-11). See Season Type Mapping for details.


Example Error Response

{
    "error": "Invalid input. Please ensure that the hair, skin, and eye color indices are correct."
}

PARAMETER DESCRIPTIONS

Hair Colors (parameter name: hairColor, type: Integer)

Index Description
0 Warm-toned light blonde or very light hair
1 Blonde
2 Light brown
3 Warm red-toned strawberry blonde
4 Warm red-toned auburn
5 Medium to dark brown or black
6 Gray with yellow tone
7 Ash gray or ash blonde
8 Ash brown, black-brown


Hair Additional Parameters 
(parameter name: hairParamX, type: Boolean)

Index Description
0 Have warm, golden tones
1 Have ash or cool tone
2 Have soft grayish, blondish tone


Selecting hair colors – Example Layouts

Eye Colors (parameter name: eyeColor, type: Integer)

Index Description
0 Gray
1 Blue
2 Topaz
3 Green
4 Hazel
5 Amber
6 Light or soft brown
7 Brown
8 Black or deep brown
9 Other or hard to identify


Eye Additional Parameters
 (parameter name: eyeParamX, type: Boolean)

Index Description
0 Notable contrast between the white area and the iris color with lighter eyes
1 Notable contrast with darker eyes
2 Have pale eyes with lighter tone
3 Eyes with soft and muted color
4 Have light eyes
5 Have dark eyes
6 Dark eyebrows and eyelashes
7 Reddish or blonde eyelashes
8 Have pale eyelashes
9 Have darker, purple area under the eyes


Selecting eye colors – 
Example Layouts


Skin Colors 
(parameter name: skinColor, type: Integer)

Index Description
0 Porcelain
1 Ivory
2 Peachy
3 Beige
4 Olive, light brown
5 Brown, dark brown
6 Very dark


Skin Additional Parameters 
(parameter name: skinParamX, type: Boolean)

Index Description
0 Burns easily in the sun
1 Tans easily
2 Tends to blush easily
3 Have cool, blue, pinkish, or ebony undertone, usually with blue or purple veins on the wrist
4 Have silver or ashy tone
5 Warm or golden tone, usually with green or olive veins on the wrist
6 Light to very light tone
7 Have freckles
8 Have only a little contrast between hair, eye, and skin color
9 Have darker tones

Selecting skin colors – Example Layouts

 Descriptions of the skin types

Skin type Description
porcelain pale skin, with pinkish tone, the lightest type, burns very easily, never tans
Ivory pale skin, often with a neutral yellow undertone, burns easily and rarely tans
Peachy with warm yellow or golden undertones, usually burns, tans with difficulty
Beige mostly warm-neutral toned, burns on occasion and tans with difficulty
Olive, light brown with warm or neutral undertones, lighter olive types usually have cooler tones, rarely burns, tans easly

Brown, dark brown

Very dark

usually tan quickly, almost never burns in the sun

tan quickly, never burns in the sun

 

Season Type Mapping (parameter name: resultSeason, type: Integer)

Index Season Type – Name
0 Warm Spring
1 Clear Spring
2 Light Spring
3 Cool Summer
4 Light Summer
5 Soft Summer
6 Warm Autumn
7 Deep Autumn
8 Soft Autumn
9 Cool Winter
10 Deep Winter
11 Clear Winter


Integration Tips

  1. Ensure the request body follows the JSON format.
  2. Validate user input to ensure all mandatory parameters are provided.
  3. Use the resultSeason integer to map to the respective season type name. Refer to Season Type Mapping section.
  4. Provide a guide for selecting skin types, including brief skin type descriptions to assist users. Refer to Description of the skin types section.

Terms and Conditions

https://brilliantseasons.net/terms-and-conditions-quiz-api/

Contact Support

For issues or questions, contact support at