> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 用户媒体内容
> 获取指定用户发布的媒体类推文，返回包含图片、视频等媒体内容的时间线和用户资料。适用于图片/视频内容采集、素材监测和账号媒体分析。
🪙1 credit每次请求
## Copy for AI
🤖 让 AI 帮你写调用代码
点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。
## OpenAPI
````yaml zh/twitter.zh.openapi.json GET /v1/twitter/usermedia
openapi: 3.0.1
info:
title: Twitter API 中文文档
description: Twitter API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
version: 1.0.0
servers:
- url: https://api.keyapi.ai
description: Production
security:
- JWT Bearer: []
tags: []
paths:
/v1/twitter/usermedia:
get:
tags: []
summary: 用户媒体内容
description: 获取指定用户发布的媒体类推文，返回包含图片、视频等媒体内容的时间线和用户资料。适用于图片/视频内容采集、素材监测和账号媒体分析。
parameters:
- name: screenname
in: query
description: Twitter / X 用户名，不包含 @。
required: true
example: elonmusk
schema:
type: string
example: elonmusk
- name: rest_id
in: query
description: 用户ID；传入后会优先使用该 ID 查询。
required: false
example: ''
schema:
type: string
- name: cursor
in: query
description: 分页游标，用于继续获取下一页媒体内容。
required: false
schema:
type: string
responses:
'200':
description: 请求成功
content:
application/json:
schema:
type: object
properties: {}
example:
code: 0
message: success
data:
timeline:
- tweet_id: '2053181971644416080'
bookmarks: 16532
created_at: Sat May 09 18:35:02 +0000 2026
favorites: 212590
text: >-
The human-perceived RGB is image 1 and the Tesla AI
photon count reconstruction is image 2.
This is why Tesla FSD can see so well at night or
through extreme glare. https://t.co/ttBMzgpJtd
lang: en
source: >-
Twitter for iPhone
views: '39841529'
quotes: 1065
replies: 6196
retweets: 18438
conversation_id: '2053181971644416080'
media:
photo:
- media_url_https: https://pbs.twimg.com/media/HH5eH0kbYAE6TjX.jpg
id: '2053181968591052801'
- media_url_https: https://pbs.twimg.com/media/HH5eH0pbAAABYsv.jpg
id: '2053181968611999744'
author:
rest_id: '44196397'
name: Elon Musk
screen_name: elonmusk
avatar: null
blue_verified: true
- tweet_id: '2052890115421417647'
bookmarks: 596
created_at: Fri May 08 23:15:19 +0000 2026
favorites: 17550
text: https://t.co/CrThu6GaBY
lang: zxx
source: >-
Twitter for iPhone
reply_to: '2052864667836649722'
views: '1535717'
quotes: 218
replies: 1428
retweets: 2908
conversation_id: '2052864667836649722'
media:
photo:
- media_url_https: https://pbs.twimg.com/media/HH1Urh9bIAASNtb.jpg
id: '2052890111977922560'
author:
rest_id: '44196397'
name: Elon Musk
screen_name: elonmusk
avatar: null
blue_verified: true
- tweet_id: '2051189101043523709'
bookmarks: 4869
created_at: Mon May 04 06:36:05 +0000 2026
favorites: 74627
text: Rivers of Blood https://t.co/U34C9AVOEl
lang: en
source: >-
Twitter for iPhone
views: '18518976'
quotes: 531
replies: 3985
retweets: 9491
conversation_id: '2051189101043523709'
media:
photo:
- media_url_https: https://pbs.twimg.com/media/HHdJncwa4AAoqz4.jpg
id: '2051189097373556736'
author:
rest_id: '44196397'
name: Elon Musk
screen_name: elonmusk
avatar: null
blue_verified: true
quoted:
tweet_id: '2051058601553207610'
bookmarks: 523
created_at: Sun May 03 21:57:32 +0000 2026
favorites: 7292
text: >-
This parasitic idea stems from the anthropologists of
peace who preached the Noble Savage canard (as per
Jean-Jacques Rousseau). @elonmusk is exactly right.
History is paved with rivers of blood and conflict.
Violence has shaped our phylogenetic history.
lang: en
views: '18481039'
quotes: 59
replies: 418
retweets: 674
conversation_id: '2051058601553207610'
author:
rest_id: '116579971'
name: Gad Saad
screen_name: GadSaad
avatar: null
blue_verified: true
media: []
next_cursor: DAABCgABHILeT3t___0KAAIcd0meptogfQgAAwAAAAIAAA
status: ok
user:
status: active
profile: null
rest_id: '44196397'
blue_verified: true
verification_type: null
affiliates:
label:
badge:
url: >-
https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg
description: X
url:
url: https://twitter.com/X
urlType: DeepLink
userLabelDisplayType: Badge
userLabelType: BusinessLabel
business_account: []
avatar: >-
https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg
header_image: https://pbs.twimg.com/profile_banners/44196397/1774145451
desc: https://t.co/dDtDyVssfm
name: Elon Musk
protected: false
location: ''
friends: 1325
sub_count: 239955338
statuses_count: 102416
media_count: 4487
created_at: Tue Jun 02 20:12:29 +0000 2009
pinned_tweet_ids_str: null
id: '44196397'
requestId: 313c0677-d321-4ad7-9031-61d776a1b2dd
headers: {}
'400':
description: 请求参数错误，请检查必填字段和参数格式
content:
application/json:
schema:
type: object
example:
code: 400
data: null
message: Missing required parameter
'401':
description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
content:
application/json:
schema:
type: object
example:
code: 401
data: null
message: apiKey is null
'402':
description: 账户余额或额度不足
content:
application/json:
schema:
type: object
example:
code: 402
data: null
message: apiKey quota is not enough
'429':
description: 请求过于频繁，已触发限流
content:
application/json:
schema:
type: object
example:
code: 429
data: null
message: qps limit exceeded
'500':
description: 服务器内部错误，请稍后重试
content:
application/json:
schema:
type: object
example:
code: 500
data: null
message: Internal server error
deprecated: false
security:
- JWT Bearer: []
x-codeSamples:
- lang: curl
label: cURL
source: |-
curl --request GET \
--url 'https://api.keyapi.ai/v1/twitter/usermedia?screenname=elonmusk&rest_id=' \
--header 'Authorization: Bearer '
- lang: python
label: Python
source: |-
import requests
response = requests.get(
'https://api.keyapi.ai/v1/twitter/usermedia',
params={"screenname": "elonmusk", "rest_id": ""},
headers={'Authorization': 'Bearer '}
)
print(response.json())
- lang: javascript
label: JavaScript
source: >-
const params = new URLSearchParams({"screenname": "elonmusk",
"rest_id": ""});
const response = await
fetch(`https://api.keyapi.ai/v1/twitter/usermedia?${params}`, {
method: 'GET',
headers: { 'Authorization': 'Bearer ' }
});
const data = await response.json();
console.log(data);
components:
securitySchemes:
JWT Bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: |-
接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer `。
可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。
````