X API
以编程方式与 X(Twitter)交互,用于发布、读取、搜索和分析。
何时激活
- 用户希望以编程方式发布推文或帖子串
- 从 X 读取时间线、提及或用户数据
- 在 X 上搜索内容、趋势或对话
- 构建 X 集成或机器人
- 分析和参与度跟踪
- 用户提及"发布到 X"、"发推"、"X API"或"Twitter API"
认证
OAuth 2.0 Bearer 令牌(仅应用)
最佳适用场景:读取密集型操作、搜索、公开数据。
# Environment setup
export X_BEARER_TOKEN="your-bearer-token"
import os
import requests
bearer = os.environ["X_BEARER_TOKEN"]
headers = {"Authorization": f"Bearer {bearer}"}
# Search recent tweets
resp = requests.get(
"https://api.x.com/2/tweets/search/recent",
headers=headers,
params={"query": "claude code", "max_results": 10}
)
tweets = resp.json()
OAuth 1.0a(用户上下文)
必需用于:发布推文、管理账户、私信。
# Environment setup — source before use
export X_API_KEY="your-api-key"
export X_API_SECRET="your-api-secret"
export X_ACCESS_TOKEN="your-access-token"
export X_ACCESS_SECRET="your-access-secret"
import os
from requests_oauthlib import OAuth1Session
oauth = OAuth1Session(
os.environ["X_API_KEY"],
client_secret=os.environ["X_API_SECRET"],
resource_owner_key=os.environ["X_ACCESS_TOKEN"],
resource_owner_secret=os.environ["X_ACCESS_SECRET"],
)
核心操作
发布一条推文
r…