# Toutiao Details API (toutiao.profile)

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

Toutiao Details looks up one Toutiao account's public profile, given its `user_id`: nickname, bio, avatar, profile link, whether the account is verified, and the verification description. It answers who is behind an account, which media monitors, PR teams and researchers need when they attribute articles to an author, confirm that a source is the verified outlet it claims to be, or keep author records up to date.

Key your records on `user_id` rather than `nickname`, which is only a display name. `bio` is the account's own description and may hold line breaks and emoji, so tidy it before you search it for keywords. `url` gives the profile address to cite in a report or to open when you check an account by hand.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| user_id | not declared | yes | not declared | Target user profile token or `secUid`, typically starting with `MS4w`. A full Toutiao profile URL can also be passed in this field. It does not accept display nicknames or short numeric UIDs. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| nickname | platform-native meaning |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| url | Link to the record on the platform. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| verify_reason | platform-native meaning |
| 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": "toutiao",
  "action": "profile",
  "params": {
    "user_id": "MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw"
  }
}'
```

```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": "toutiao",
        "action": "profile",
        "params": {
            "user_id": "MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw",
        },
    },
    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": "toutiao",
  "action": "profile",
  "results": {
    "user_id": "MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw",
    "nickname": "•••",
    "bio": "闪电新闻，先声夺人。山东广播电视台倾力打造的融媒体客户端。",
    "url": "https://www.toutiao.com/c/user/token/MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw/",
    "avatar_url": "https://p3-sign.toutiaoimg.com/•••",
    "is_verified": true,
    "verify_reason": "闪电新闻官方账号",
    "platform": "toutiao"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Where do I find a Toutiao `user_id`?

Open the account's profile on Toutiao and copy the address: the long token in it, usually starting with MS4w, is the `user_id`, and you can also pass the address as a whole. Nicknames and the short numeric UIDs some pages show cannot identify an account here.

### What does `verify_reason` add to `is_verified`?

`is_verified` only says whether Toutiao verified the account, and null there means the status could not be determined. `verify_reason` is the description attached to the verification, which tells you what kind of account it is; keep it when you sort sources into outlets, organizations and individual writers.

### How do I see what the account publishes?

Pass the same `user_id` to the Toutiao Posts by user capability, which lists the account's articles, videos and short posts with reads, plays and engagement. To look for posts on one subject within the account, the Toutiao Profile search capability takes the same ID plus a keyword.

## Also

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