Topview-api

Public product avatar Query

Developing

GET

/v1/product_avatar/public_avatar/query

Request

Query Params

ethnicityIds

string

optional

ethnicityIds，separated by commas in English

gender

enum<string>

optional

male/female

Allowed values:

femalemale

sortingType

enum<string>

optional

Allowed values:

PopularityNewest

categoryIds

string

optional

categoryIds，separated by commas in English

pageNo

string

optional

Default value: 1

pageSize

string

optional

Default value: 20

Header Params

Authorization

string

required

Topview-Uid

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.topview.ai/v1/product_avatar/public_avatar/query?ethnicityIds=&gender=&sortingType=&categoryIds=&pageNo=&pageSize=' \
--header 'Authorization;' \
--header 'Topview-Uid;'

Responses

🟢200OK

application/json

Body

code

string

required

message

string

required

result

object

required

total

integer

required

pageNo

integer

required

pageSize

integer

required

data

array [object {8}]

required

Example

{
    "code": "string",
    "message": "string",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "avatarId": "string",
                "avatarImagePath": "string",
                "voiceoverId": "string",
                "gender": "string",
                "avatarCategoryList": [
                    {
                        "categoryId": "string",
                        "categoryName": "string"
                    }
                ],
                "objectMaskImageInfo": "string",
                "avatarEthnicityList": [
                    {
                        "ethnicityId": "string",
                        "ethnicityName": "string"
                    }
                ],
                "minSubsType": "string"
            }
        ]
    }
}

Modified at 2025-05-12 03:19:14

Category Query

submit task