Face & Head Shape Detector API

The Head Shape Detector API returns precise shape data in seconds with a clear JSON response, so developers can power personalized haircut, hat, and eyewear recommendations for grooming, fashion, and e-commerce.

How to Use the Head Shape Detector API in 3 Steps

Go from photo to personalized recommendation in seconds, with no complex setup required.

STEP1
step icon
Initialize Request

Send a request with the user image file.

STEP2
step icon
AI Processing

AI will first check if the uploaded photo meets the requirements. If it does, AI will start generating the results.

STEP3
step icon
See Your Results

Receive the full report.

How AI Head Shape Detection Works

  • Analyzes from a single uploaded photo
  • Shares its detection foundation with Perfect Corp's Face Shape Detector API.
  • Built on a decade of AI development and a dataset of 100,000+ images.
  • Returns a clear report or complete JSON response
  • Trained across diverse genders and ethnic backgrounds
AI analyzing head shape contour from a photo using the Head Shape Detector API

Classify Every Head Shape Type

The API sorts head shape into the categories:.

  • Oval, the most balanced and versatile shape
  • Round, with fuller width at the sides
  • Square, marked by a strong, angular jawline
  • Diamond, oblong, triangle, heart.
Chart showing oval, round, square, and diamond head shape classifications

Power Smarter Haircut Recommendations

  • Helps apps suggest the best cuts for different face shapes
  • Supports barbershop booking apps and virtual consultation tools
  • Guide product recommendations
Barbering app recommending a haircut based on detected head shape

Expand Your Integration: Advanced Personalization APIs

Face Shape Detector API
Face Shape Detector API

Analyze 50+ facial features and 11 facial ratios to classify face shape, giving beauty and eyewear brands another layer of personalization.

AI Hairstyle Try-On API

Let customers try on realistic, strand level hairstyles in a single API call, from bobs and pixies to trending fades.

AI Hat Virtual Try-On API
AI Hat Virtual Try-On API

Power realistic virtual try-on for hats and headwear, pairing naturally with head shape data for a better fit recommendation.

Let's Build a Smarter Head Shape Experience Together

Head Shape Detector API FAQ