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?
✅ Proven & trusted – The Quiz has already been completed by countless real users in our high-rated apps.
Who Can Benefit?
– Personal styling platforms
Unlock the power of Seasonal Color Analysis to enhance user experience and boost conversions!
REQUEST 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
- Ensure the request body follows the JSON format.
- Validate user input to ensure all mandatory parameters are provided.
- Use the resultSeason integer to map to the respective season type name. Refer to Season Type Mapping section.
- 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/