Platform Playground

See the Scanner Platform in action

The Bodygram Scanner Platform returns raw body measurements from two photos and user stats, or from stats alone. Unlike Body2Fit, there are no garments or size labels — you get the underlying measurement data directly and decide what to do with it.

This page lets you run the complete integration flow against your own credentials. Use it to understand each step before wiring it into your own application.

For the full integration guide, see Platform Integration.

Integration pattern

Every Platform integration follows four steps. The playground below runs all four live:

1. Configure — initialize the SDK with your organization ID and locale. Generate a scan token on your server using your API key (this playground does it in the browser for convenience — never do this in production).
2. User stats — collect the user's gender, age, height, and weight.
3. Scan & estimate — optionally capture front and side photos with Scanflow, then call the estimation API to get body measurements.
4. Measurements — view the full set of body dimensions in centimeters. Photo scans also return body composition and posture data.

// ---- Backend Code Start ----
// Run this on your server.
// Never expose your API key to the browser.
//
// './sdk.es.js' is the path where you have downloaded
// the Bodygram Headless SDK (ES build). See the full
// server setup pattern in the integration guide:
// /headless/platform-integration#real-world-example-dashboard-app
import BodygramSDK from './sdk.es.js';

const serverSdk = new BodygramSDK({
  clientKey: 'org_...',
});

async function createScanToken() {
  const { token } = await serverSdk.getBodygramScannerPlatformScanToken({
    apiKey: process.env.BODYGRAM_API_KEY,
    scope: [
      'api.platform.bodygram.com/scans:create',
      'api.platform.bodygram.com/scans:read',
    ],
  });
  return token;
}
// ---- Backend Code End ----

// ---- Frontend Code Start ----
const sdk = new BodygramSDK({
  clientKey: 'org_...',
  locale: 'en',
});
// ---- Frontend Code End ----

API reference

Full signatures, parameters, and response shapes for every method used in the playground above live in the Headless SDK API reference.

Methods

• getBodygramScannerPlatformScanToken(params) — server-side. Generates a short-lived JWT scan token from your API key. Never call this from the browser.
• getBodygramScannerPlatformPhotoEstimation(params) — client-side. Returns full body measurements from front and side photos plus user stats, alongside body composition, avatar, and posture data.
• getBodygramScannerPlatformStatsEstimation(params) — client-side. Returns body measurements and a 3D avatar from age, gender, height, and weight alone (no photos; body composition and posture are not returned).

Types

• PlatformMeasurement — shape of each entry in entry.measurements, plus the full list of measurement names.
• Avatar — shape of the 3D avatar returned by photo and stats estimation.
• Posture — front and right pose data, including angle and line landmark definitions and the dashboard naming map.