Skip to navigation
Products

Makeup and hair catalogue

Every category, option and texture the V1 API accepts.

GET /v1/makeup/capabilities answers the same declaration as JSON, with a declaration_digest that changes whenever what may be sent changes.

Custom mode

A custom product is "mode": "custom", a category, a color (#RGB or #RRGGBB) and the options below; the server resolves the rest from the category’s current profile. An option left out takes its default.

CategoryOptionsProfile
foundationintensity: medium (default), strongfoundation.natural v2
blushintensity: medium (default), strongblush.standard v2
contourintensity: medium (default), strongcontour.standard v2
eyeshadowintensity: medium (default), strongeyeshadow.lid v2
eyelinerstyle: normal (default), dark_matte; intensity: medium (default), strongeyeliner.standard v2
highlighterintensity: medium (default), stronghighlighter.standard v2
mascarastyle: volume (default), curl, length, volume_curl, volume_length, curl_length, volume_curl_lengthmascara.standard v2
lipstickfinish: matte (default), gloss, metalliclipstick.standard v2
lip_linerintensity: medium (default), stronglip_liner.standard v2
concealerintensity: medium (default), strongconcealer.standard v2
bronzerintensity: medium (default), strongbronzer.standard v2

Foundation

category: foundation

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
finishnatural, brightnatural
coveragenumber 0–1.51.0
coverage_opacitynumber 0.5–1.51.0
coverage_face_blurnumber 0.5–1.51.0

Known limitations:

  • finish: bright renders like natural; use coverage or opacity for a visible change.

Blush

category: blush

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required
glitter.texturetexture id (below)required in glitter
glitter.opacitynumber 0–11.0

Textures:

  • blush.1 — Blush 1
  • blush.2 — Blush 2
  • blush.3 — Blush 3
  • blush.4 — Blush 4
  • blush.diamond — Diamond
  • blush.heart — Heart
  • blush.new — New
  • blush.square — Square

Glitter textures (glitter.texture):

  • glitter.1 — Glitter 1
  • glitter.2 — Glitter 2
  • glitter.3 — Glitter 3

Known limitations:

  • opacity: 0 renders no product; leave the product out instead.

Contour

category: contour

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required

Textures:

  • contour.1 — Contour 1
  • contour.2 — Contour 2
  • contour.3 — Contour 3
  • contour.4 — Contour 4
  • contour.5 — Contour 5
  • contour.6 — Contour 6

Known limitations:

  • texture: contour.1 is the same artwork as bronzer.1.
  • opacity: 0 renders no product; leave the product out instead.

Eyeshadow

category: eyeshadow

FieldAcceptsDefault
texturetexture id (below)required
shadesarray of {color, opacity}, one per texture slotrequired

Textures:

  • eyeshadow.mostly-lids-eyeshadow — Eyeshadow - Mostly Lids
  • eyeshadow.neon — Neon
  • eyeshadow.pastel — Pastel
  • eyeshadow.primary — Primary

Eyeliner

category: eyeliner

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required
stylenormal, dark_mattenormal

Textures:

  • eyeliner.1 — Eyeliner 1
  • eyeliner.eyepencil-1 — Eye Pencil 1

Known limitations:

  • opacity: 0 renders no product; leave the product out instead.

Highlighter

category: highlighter

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required
silverybooleanfalse
silvery_opacitynumber 0–10.5
coloredbooleanfalse
light_controlinteger 0–10050
reflectance_controlinteger 0–10050
intensityinteger 0–10050

Textures:

  • highlighter.1 — Highlighter 1
  • highlighter.2 — Highlighter 2
  • highlighter.3 — Highlighter 3
  • highlighter.4 — Highlighter 4
  • highlighter.5 — Highlighter 5
  • highlighter.6 — Highlighter 6
  • highlighter.7 — Highlighter 7
  • highlighter.8 — So Diffused

Known limitations:

  • opacity: renders like the default; intensity (0 to 100) is the strength control.
  • silvery_opacity: has no effect unless silvery is true.

Mascara

category: mascara

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required
stylevolume, curl, length, volume_curl, volume_length, curl_length, volume_curl_lengthvolume

Textures:

  • mascara.1 — Mascara 1

Known limitations:

  • opacity: 0 renders no product; leave the product out instead.

Lipstick

category: lipstick

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
finishmatte, gloss, metallicmatte
lookfull, ombrefull
ombre{color, opacity}required for look: ombre
shading.darkness_opacitynumber 0–10.8
shading.darkness_smoothinteger 0–41
shading.lightness_opacitynumber 0–10.4
shading.lightness_smoothinteger 0–42
shading.reflectancenumber 0–10.9
shading.reflectance_opacitynumber 0–10.24

Known limitations:

  • shading: reflectance has no effect on the default matte finish; use finish gloss or metallic.
  • opacity: 0 renders no product; leave the product out instead.

Lip liner

category: lip_liner

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
thicknessnumber 0–10.0
widenessnumber 0–10.0
upper_lip_offsetnumber 0–10.0
lower_lip_offsetnumber 0–10.0

Known limitations:

  • opacity: 0 renders no product; leave the product out instead.

Concealer

category: concealer

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required
coveragenumber 0–1.51.0

Textures:

  • concealer.1 — Concealer 1

Bronzer

category: bronzer

FieldAcceptsDefault
color#RRGGBBrequired
opacitynumber 0–1, step 0.011
texturetexture id (below)required

Textures:

  • bronzer.1 — Bronzer 1
  • bronzer.2 — Bronzer 2
  • bronzer.3 — Bronzer 3
  • bronzer.4 — Bronzer 4
  • bronzer.5 — Bronzer 5

Known limitations:

  • texture: bronzer.1 is the same artwork as contour.1.
  • opacity: 0 renders no product; leave the product out instead.

Hair

POST /v1/hair/try-ons takes an optional blend:

  • tint
  • color (default)
  • overlay

Not available

  • Eye pencil (eye_pencil): not available.
  • Eyebrow (eyebrow): not available.
  • Fun mask (fun_mask): not available.
  • Textured lipstick (sheer, shimmer, glitter and semi-bright finishes): not available.

A category or texture missing from this page is refused with 400 INVALID_REQUEST; a category’s detail code is unsupported_category.