---
title: "Create a product analysis"
method: POST
path: "/unstable/analysis"
tags: ["Analysis"]
---

# Create a product analysis

`POST /unstable/analysis`

## Request

- Base URL: `https://api.authentified.co`
- URL: `https://api.authentified.co/unstable/analysis`
- Auth: API key in header `X-Authentified-API-Key`

Create a product analysis

## Request body

- object
  - `images` object[], required: Images to analyse
    - `id` string, required: The image identifier
    - `url` string, uri, required: The image URL
  - `async` boolean: Whether to process the analysis asynchronously
  - `callbackUrl` string, uri: The URL to send the analysis result to when processing asynchronously

## Response `201`

Product analysis created successfully

- object: Product analysis created successfully
  - `uuid` string, uuid: The UUID of the product analysis
  - `status` 'started' | 'failed' | 'finalising' | 'complete': The current status of the analysis
  - `images` object[]: Images to analyse
    - `id` string, required: The image identifier
    - `url` string, uri, required: The image URL
  - `result` object, nullable: The analysis result containing predicted facets
    - `usage` object
      - `duration` number
      - `totalTokens` number
    - `output` object
      - `model` string
      - `version` string
      - `provider` string
      - `prediction` object
        - `size` object
          - `value` unknown
          - `confidence` number
        - `brand` object
          - `value` unknown
          - `confidence` number
        - `title` object
          - `value` unknown
          - `confidence` number
        - `colour` object
          - `value` unknown
          - `confidence` number
        - `weight` object
          - `value` unknown
          - `confidence` number
        - `category` object
          - `value` unknown
          - `confidence` number
        - `condition` object
          - `value` unknown
          - `confidence` number
        - `description` object
          - `value` unknown
          - `confidence` number
        - `minimumPrice` object
          - `value` unknown
          - `confidence` number
        - `imperfections` object
          - `value` unknown
          - `confidence` number
        - `startingPrice` object
          - `value` unknown
          - `confidence` number
        - `usedCondition` object
          - `value` unknown
          - `confidence` number
        - `imageBestSortOrder` number[]
        - `hasTagsAndPackaging` object
          - `value` unknown
          - `confidence` number
      - `schemaVersion` string

## Other responses

- `400`: Bad Request - Invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - API key does not have access to this resource

---

[API](https://skmtc.dev/authentified/apis/authentified-rest-api.md) - [All operations](https://skmtc.dev/authentified/apis/authentified-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/authentified/apis/authentified-rest-api/revisions/1c72a50690bf?raw)