# Toutiao Posts by user API (toutiao.user_posts)

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

Toutiao Posts by user lists an account's published content, given the account's `user_id`: articles, videos, short videos and short status posts, each with title, body text, cover, reads or plays, likes, comments, shares, publish time and region, plus the author's name and verification details. Content strategists and media monitors rely on it to track what an author publishes, which formats draw readers, and how a competitor's output performs over time.

`tab` picks which section of the profile you list, and it does not change how Article details reads a single post. `author_auth_info` carries the verification text Toutiao shows next to the author, such as the field they create in. `user_id` takes the same token or profile link as the Toutiao Details capability, usually a string starting with MS4w.

## Health

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

## 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. |
| tab | not declared | no | not declared | Selects the profile feed tab in `user_posts`. Allowed values are `all` (default), `article`, `video`, `ugc`, and `short_video`. It does not alter item detail types. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| type | Record type; values depend on the capability (for example video / image / text). |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| content_text | platform-native meaning |
| cover | platform-native meaning |
| read_count | platform-native meaning |
| play_count | platform-native meaning |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| share_count | Shares. null means not disclosed, not 0. |
| source | platform-native meaning |
| author_name | Author's display name. |
| author_id | The author's MS4w profile token (video, landscape videos only); pass it as `user_id` to profile or user_posts. |
| author_verified | Whether the author is verified; on comments, the commenter. |
| author_auth_info | Verification description, such as a field creator; on comments, the commenter's, such as an official account. Absent when there is none. |
| region | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| duration_sec | platform-native meaning |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| image_urls | Array of image links in the platform's display order; absent when there are no images. |

## 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": "user_posts",
  "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": "user_posts",
        "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; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "toutiao",
  "action": "user_posts",
  "results": [
    {
      "id": "•••",
      "url": "https://www.toutiao.com/article/7689787715704914442",
      "type": "article",
      "title": "2026中国国际孔子文化节｜典籍藏风骨，文脉铸脊梁",
      "text": "孔子博物馆作为山东一张重要的文化名片，承载的不只是典籍，更是融入国人血脉的精神底色。让我们与中国政法大学思政研究所教师郭继承老师一起探讨中国人延续千年的精神内核“仁义礼智信”与“家国天下”，品读千年经典，传承中华文脉。",
      "cover": "https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/52435ed17c152886afe1f7a3a38289bd~720x380_cs.webp?_iz=31826&bid=11&from=article.profile_all&gid=7689787715704914442&lk3s=06827d14&x-expires=1793010615&x-signature=qdMi0gLhunIfzbcnFlumiJGFb24%3D",
      "read_count": 0,
      "like_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "source": "闪电新闻",
      "author_name": "•••",
      "author_id": "MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw",
      "author_verified": true,
      "author_auth_info": "闪电新闻官方账号",
      "posted_at": "2026-09-26 18:24",
      "platform": "toutiao"
    },
    {
      "id": "•••",
      "url": "https://www.toutiao.com/video/7689787812941742126",
      "type": "video",
      "title": "听风营地 风里有饭香 树下有童年",
      "cover": "https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/fa36a70315d5e737371d88e5dab862c3~tplv-tt-profile_shortvideo:270:360.jpeg?_iz=3710&bid=8&from=shortvideo.profile_all&gid=7689787812941742126&lk3s=06827d14&x-expires=1791023415&x-signature=jzsygXZXKSBDCHw9hOCuvx3q%2FY8%3D",
      "read_count": 4,
      "play_count": 4,
      "like_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "author_name": "•••",
      "author_id": "MS4wLjABAAAA3KU9ifwN12G41E6PJRpZgIfzVrXWQ4WPF66ns54c0uw",
      "author_verified": true,
      "author_auth_info": "闪电新闻官方账号",
      "posted_at": "2026-09-26 18:24",
      "platform": "toutiao",
      "duration_sec": 33
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I list only videos or only articles?

Set `tab` to article for articles, to video or short_video for the two kinds of video, or to ugc for short status posts; leave it out or pass all for everything. Each value maps to one section of the author's profile, so run one call per section when you want them stored apart.

### Which count should I use to compare posts?

`read_count` for articles and `play_count` for videos, then `like_count`, `comment_count` and `share_count` for engagement, where null means not disclosed rather than zero. Check `type` on each row and rank within one type, because a read and a play are different measures.

### Can I search one author's posts by keyword?

Not with this capability, which lists posts by profile section. The Toutiao Profile search capability searches inside one account: give it the same `user_id` and a keyword. To read one post on its own, pass its `url` to the Toutiao Article details capability.

## 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
