Skip to main content
POST
/
generic
/
data
/
generate
/
color
Generate synthetic color data
curl --request POST \
  --url https://apix.spotzee.com/api/ext/generic/data/generate/color \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data count=10 \
  --data locale=en \
  --data seed=12345 \
  --data method=profile \
  --data format=css \
  --data includeAlpha=false \
  --data casing=upper \
  --data 'prefix=#' \
  --data cssColorSpace=display-p3
{
  "status": "success",
  "data": {
    "colors": [
      {
        "method": "profile",
        "value": "#4f46e5",
        "rgb": "#4f46e5",
        "cmyk": [
          0.31,
          0.52,
          0.32,
          0.43
        ],
        "colorByCSSColorSpace": "color(display-p3 0.12 1 0.23)",
        "cssSupportedFunction": "rgb",
        "cssSupportedSpace": "display-p3",
        "hsl": "hsl(0deg, 100%, 80%)",
        "human": "red",
        "hwb": "hwb(354 72% 41%)",
        "lab": "lab(29.2345% 39.3825 20.0664)",
        "lch": "lch(52.2345% 72.2 56.2)",
        "space": "sRGB",
        "format": "css",
        "includeAlpha": false,
        "cssColorSpace": "display-p3"
      }
    ],
    "generated": 1,
    "locale": "en",
    "seed": 12345,
    "method": "profile"
  },
  "performance": {
    "generationTime": 2,
    "itemsGenerated": 1,
    "locale": "en"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use format: Bearer YOUR_API_KEY

Body

application/x-www-form-urlencoded
​
count
string

Number of color records to generate (1-100). Passed as string but must be numeric.

Pattern: ^[1-9]\d?$|^100$
Example:

"10"

​
locale
string

Locale for generated data (e.g., en, es, fr, de, pt_BR, zh_CN)

Example:

"en"

​
seed
string

Seed for deterministic generation. Same seed produces same results.

Example:

"12345"

​
method
enum<string>

Color generation method. Defaults to profile.

Available options:
profile,
cmyk,
colorByCSSColorSpace,
cssSupportedFunction,
cssSupportedSpace,
hsl,
human,
hwb,
lab,
lch,
rgb,
space
Example:

"profile"

​
format
enum<string>

Output format for supported color methods. hex is supported only by rgb and profile.

Available options:
decimal,
css,
binary,
hex
Example:

"css"

​
includeAlpha
enum<string>

Include alpha in rgb, hsl, or profile output.

Available options:
true,
false
Example:

"false"

​
casing
enum<string>

Hex output letter casing for rgb or profile output.

Available options:
upper,
lower
Example:

"upper"

​
prefix
string

Hex output prefix for rgb or profile output. Maximum 4 characters.

Maximum string length: 4
Example:

"#"

​
cssColorSpace
enum<string>

CSS color space for colorByCSSColorSpace or profile output.

Available options:
sRGB,
display-p3,
rec2020,
a98-rgb,
prophoto-rgb
Example:

"display-p3"

Response

Successfully generated color data

​
status
enum<string>
required
Available options:
success
​
data
object
required
​
performance
object