---
name: "getTimbreMarketList"
mode: "api"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.6" }
---

## getTimbreMarketList

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.6

> 💡 This API relies on cloud capabilities. Grant authorization in Development Settings - Cloud Capabilities on the [Mini App Developer Platform](https://platform.tuya.com/miniapp/).

### Description

Get paginated list of standard timbres.

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetTimbreMarketListParams` | Yes | Request body |

### Return Value

Type: `Promise<GetTimbreMarketListResult>`

GetTimbreMarketListResult (see type definitions and minituya response parameters for field meanings)

### Referenced Types

##### `interface` GetTimbreMarketListParams

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `devId` | `string` | Yes | Device ID |
| `tag` | `string` | No | Timbre tag |
| `keyWord` | `string` | Yes | Timbre name |
| `lang` | `string` | No | Language |
| `pageNo` | `number` | Yes | pageN0 |
| `pageSize` | `number` | Yes | pageSize |

##### `type` GetTimbreMarketListResult

```typescript
CommonPageResult<GetTimbreMarketListItem>
```


### Examples

#### Request example

```typescript
import { getTimbreMarketList } from '@tuya-miniapp/cloud-api';

const params = {
  devId: 'your_device_id',
  tag: 'gentle',
  keyWord: 'gentle',
  lang: 'zh-CN',
  pageNo: 1,
  pageSize: 10,
};

getTimbreMarketList(params)
  .then(result => {
    console.log('Timbre list:', result);
  })
  .catch(error => {
    console.error('Failed to get timbre list:', error);
  });
```

#### Response example

```json
{
  "page": 1,
  "pageSize": 10,
  "totalPage": 1,
  "total": 1,
  "list": [
    {
      "voiceId": "voice_001",
      "voiceName": "Gentle female voice",
      "descTags": [
        "Gentle",
        "Sweet",
        "Professional"
      ],
      "supportLangs": [
        "zh-CN",
        "en-US"
      ],
      "speedAdjustable": true,
      "speed": 1,
      "toneAdjustable": true,
      "tone": 0.8,
      "demoUrl": "https://example.com/demo_voice.mp3"
    }
  ]
}
```