# Youku Details API (youku.profile)

- Canonical page: [https://everyinfra.com/en/youku-api/profile](https://everyinfra.com/en/youku-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "youku", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Youku Details reads one creator's public profile from the encoded `user_id` and returns the name, bio, avatar, gender, location, follower and like counts, verification status with its description, the numeric ID and the profile link. Brands, agencies and media researchers use it to vet Youku creators before a partnership, compare accounts by audience size, or keep a current record of the channels they follow.

`user_id` is an encoded creator UID such as UMzkwNzY4NzQw, not a username, show ID or profile URL. `numeric_id` is the same account's numeric ID, worth keeping for matching. `location` is passed through as Youku shows it, and a null `follower_count` or `like_count` means the number is not public, not that it is zero.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=youku&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| user_id | not declared | yes | not declared | The encoded creator UID required by the profile action, retrieved from video author metadata. Do not provide a username, show ID, or full channel homepage URL. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| numeric_id | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| gender | platform-native meaning |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| follower_count | Followers. null means not disclosed, not 0. |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| verified_desc | platform-native meaning |
| location | Location description passed through as is; the format varies by platform. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "youku",
  "action": "profile",
  "params": {
    "user_id": "UMzkwNzY4NzQw"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "youku",
        "action": "profile",
        "params": {
            "user_id": "UMzkwNzY4NzQw",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "youku",
  "action": "profile",
  "results": {
    "user_id": "•••",
    "numeric_id": "•••",
    "name": "YKYX0728249",
    "url": "https://m.youku.com/profile?uid=UMzkwNzY4NzQw",
    "avatar_url": "https://static.youku.com/•••",
    "gender": 0,
    "like_count": 0,
    "is_verified": false,
    "platform": "youku"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Where do I find the encoded `user_id`?

Read one of the creator's videos with the Youku Video details capability: the author details it returns include the creator's encoded UID, a string such as UMzkwNzY4NzQw. Pass that string alone; a full profile URL in this field does not work.

### What is the difference between `user_id` and `numeric_id`?

Both identify the same account. `user_id` is the encoded UID this capability takes as input, and `numeric_id` is the plain numeric form. Store both so you can match the account whichever form another source uses.

### How do I read a creator's verification?

`is_verified` says whether Youku verified the account; when it is null, the status is unknown rather than negative. `verified_desc` carries the verification note Youku shows, which helps tell official channels from personal accounts.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=youku
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
