---
title: "Localize a brand name into Mandarin Hanzi candidates with dialect screening."
method: POST
path: "/mandarin/localize"
tags: ["localize"]
---

# Localize a brand name into Mandarin Hanzi candidates with dialect screening.

`POST /mandarin/localize`

## Request

- Base URL: `https://api.etymolt.com`
- URL: `https://api.etymolt.com/mandarin/localize`
- Auth: none declared

## Request body

- MandarinLocalizeRequest
  - `name` string, required
  - `desired_meaning` string[]
  - `nice_classes` integer[]
  - `return_top_n` integer

## Response `200`

Successful Response

- MandarinLocalizeResponse
  - `name` string, required
  - `candidates` MandarinCandidate[], required
    - `pinyin` string, required
    - `characters` string, required
    - `literal_meaning` string, required
    - `poetic_reading` string, required
    - `tone_pattern` string, required
    - `phonetic_distance` number, required
    - `semantic_score` number, required
    - `cantonese_check` 'CLEAN' | 'SOFT_FLAG' | 'HARD_FLAG', required
    - `shanghainese_check` 'CLEAN' | 'SOFT_FLAG' | 'HARD_FLAG', required
    - `nice_subclass_collisions` string[]
    - `composite` number, required
  - `benchmark_pairs` object[], required
  - `duration_ms` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names.md) · [All operations](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/llms.txt) · [OpenAPI document](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/revisions/7228ffa1efa7?raw)