---
document_id: agent.collection.task.twitter_user_profile_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# User profile / 用户资料

Fetch an X user's public profile.

取一个 X 用户的公开资料。

Task / 任务: `twitter_user_profile_v1`
Platform / 平台: X (Twitter) / X（推特）
Billing / 计费: 2 Credits per successful task / 每个成功任务 2 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- screen_name 不含 @ 前缀。
- 上游不返回该用户的 handle（只有显示名），调用方本来就知道自己查的是谁。
- 粉丝数是 sub_count，关注数是 friends。

## Inputs / 输入

- `screen_name` — Screen name / 用户名; kind=text; required=True; default=''; bounds=min_length=1, max_length=15

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "获取 X 用户 NASA 的公开资料",
  "task_code": "twitter_user_profile_v1",
  "input": {
    "screen_name": "NASA"
  }
}
```


## Result and pagination / 结果与分页

- mode=none

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.item` — type=object|null; Projected public detail, or null when absent. / 投影后的公开详情；不存在时为 null。
- `data.item.author_id` — type=scalar|null; Author identifier, when available. / 作者 ID（如有）。
- `data.item.author_name` — type=scalar|null; Author display name, when available. / 作者名称（如有）。
- `data.item.description` — type=scalar|null; Description, when available. / 描述（如有）。
- `data.item.follower_count` — type=scalar|null; Follower count, when available. / 粉丝数（如有）。
- `data.item.following_count` — type=scalar|null; Following count, when available. / 关注数（如有）。
- `data.item.post_count` — type=scalar|null; Post count, when available. / 帖子数（如有）。
- `data.item.media_count` — type=scalar|null; Media count, when available. / 媒体数（如有）。
- `data.item.is_verified` — type=scalar|null; Is verified, when available. / 是否已认证（如有）。
- `data.item.is_protected` — type=scalar|null; Is protected, when available. / 是否受保护（如有）。
- `data.item.verification_type` — type=scalar|null; Verification type, when available. / 认证类型（如有）。
- `data.item.location` — type=scalar|null; Location, when available. / 地点（如有）。
- `data.item.website` — type=scalar|null; Website, when available. / 网站（如有）。
- `data.item.created_at` — type=scalar|null; Creation time, when available. / 创建时间（如有）。
- `data.item.avatar` — type=scalar|null; Avatar, when available. / 头像（如有）。
- `data.item.header_image` — type=scalar|null; Header image, when available. / 主页封面图片（如有）。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。