> ## Documentation Index
> Fetch the complete documentation index at: https://getfaceage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skin analyze widget

> Get a hosted skin analysis URL for your mobile app, iframe or website, and receive results at your callback URL.

Use the skin analyze widget when you want Face Age as a hosted page instead of an embedded SDK — for example inside an iOS or Android app, or in an iframe.

**1. Request a widget URL**

Call this endpoint with your Face Age ID, your callback URL and the options you want. The response contains a widget URL.

**2. Open the URL**

Open the URL in your app's web view, an iframe or a browser. The user takes a photo or uploads one, approves it, and the analysis starts.

![Instructions and consent before the photo](https://mintcdn.com/getfaceage-com/wLP35CGqBY74yiOL/images/developer-guides/sdk-instructions.jpg?fit=max\&auto=format\&n=wLP35CGqBY74yiOL\&q=85\&s=acb19bc8c736bc690423e21400d41569)

**3. Receive the results**

The analysis results are shown to the user. When they click **Done**, Face Age sends the results and the uploaded photo to your callback URL.

![Analysis results with skin age, skin health and concern masks](https://mintcdn.com/getfaceage-com/wLP35CGqBY74yiOL/images/developer-guides/sdk-results.jpg?fit=max\&auto=format\&n=wLP35CGqBY74yiOL\&q=85\&s=5b0eca69c3023058be91b38d4985eb37)

> [!NOTE]
>
> This endpoint does not use the secret key. It identifies your business with the Face Age ID from the **API keys** page of your business in the [panel](https://panel.getfaceage.com).

## Body

Send the parameters as `multipart/form-data`.

**callbackUrl** `string` *required*

URL where the analysis results are sent.

**faceAgeId** `string` *required*

Your Face Age ID (API key), from the **API keys** page in the panel.

**language** `string` (default: en)

Language of the widget.

**currency** `string` (default: \$)

Currency symbol.

**showCamera** `boolean` (default: true)

Allow users to take a photo with the camera.

**showUpload** `boolean` (default: true)

Allow users to upload an image.

**gtag** `string`

Google Analytics (GTM) ID to track the widget.

**problems** `string[]` (default: all)

Skin issues to include in the analysis. Send as `problems[0]`, `problems[1]`, and so on.

Options: `fineWrinkles`, `eyeWrinkles`, `deepWrinkles`, `darkCircle`, `eyeBag`, `pores`, `pigment`, `redness`, `oiliness`, `dryness`, `sagginess`, `dullness`, `acne`.

## Response

**status** `boolean`

`true` when the request succeeds.

**data.url** `string`

Widget URL to open. Its query string carries your settings: `faceAgeId`, the selected `problems` (as `access`), `showCamera`, `showUpload`, `showFacePoint` and `callbackUrl`.

```bash cURL theme={null}
curl --request POST 'https://core.getfaceage.com/api/v1/widget/skin-analyze/set-parameters' \
  --header 'Accept: application/json' \
  --form 'callbackUrl="https://www.your-domain.com/analyze-face-callback"' \
  --form 'faceAgeId="your_face_age_id"' \
  --form 'showCamera="true"' \
  --form 'showUpload="true"' \
  --form 'language="en"' \
  --form 'currency="$"' \
  --form 'gtag=""' \
  --form 'problems[0]="fineWrinkles"' \
  --form 'problems[1]="eyeWrinkles"'
```

```json 200 theme={null}
{
  "status": true,
  "data": {
    "url": "https://panel.getfaceage.com/widget/skin-analyze?faceAgeId=your_face_age_id&type=skincare-analyzer&access=fineWrinkles,eyeWrinkles&showCamera=true&showUpload=true&showFacePoint=false&callbackUrl=your_callback_url"
  }
}
```

```json 401 theme={null}
{
  "message": "Unauthenticated."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.