---
title: "Controller Handle Train Lookalike Audience"
method: POST
path: "/audience/lookalike/train"
tags: ["audience"]
---

# Controller Handle Train Lookalike Audience

`POST /audience/lookalike/train`

Train a lookalike model for an audience

## Request body

- TrainLALPayload
  - `lal_id` string, required — The ID of the lookalike model to train
  - `audience_id` string, required — The ID of the audience to train the lookalike model on
  - `options` TrainLALOptions, required
    - `household` boolean, required — Whether to train at the household level
    - `locality_type` 'zip' | 'dma'

## Response `201`

Successful Response

- AudienceLAL
  - `id` string — ID of this object.
  - `_markedForDeletion` boolean — marked if record has been soft-deleted.
  - `created_at` union — datetime object representing when this object was created.
    - string, date-time
    - object
  - `updated_at` union — datetime object representing when this object was updated.
    - string, date-time
    - object
  - `lalId` string, required — The ID of the lookalike audience.
  - `audienceId` string, required — The ID of the audience.
  - `options` object, required — The options for the lookalike audience.
  - `status` string, required — The status of the lookalike audience.
  - `inference_set_size` integer — The size of the inference set.
  - `ignore_columns` string[] — The passthrough columns of the lookalike model.
  - `probabilities` number[], nullable — The sorted probabilities of the lookalike audience.
  - `defaultStatsConfidence` number, nullable — The default stats confidence of the lookalike audience.
  - `defaultStats` object, nullable — The default stats of the lookalike audience.
  - `featureImportance` object[], nullable — The feature importance of the lookalike audience.
  - `top_factors` TopFactor[] — The top factors of the lookalike audience.
    - `name` string, required
    - `importance` number, required
    - `keyDifferences` object[], required
  - `executionDuration` number, nullable — The execution duration of the lookalike audience.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/akk/apis/fastapi.md) · [All operations](https://skmtc.net/akk/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akk/fastapi/versions/6662a407c637/schema)