🐦 Twitter API 代理

轻量级个人使用的Twitter API代理服务

📋 API 端点

获取单个推文

GET /api/tweet?id=推文ID

示例: /api/tweet?id=1234567890

获取多个推文

POST /api/tweets

Body: {"ids": ["1234567890", "0987654321"]}

搜索推文

GET /api/search?q=搜索词&count=数量

示例: /api/search?q=hello&count=10

获取用户时间线

GET /api/user/timeline?username=用户ID&count=数量&type=类型&exclude_retweets=true&exclude_replies=true

示例: /api/user/timeline?username=44196397&count=20&type=tweets&exclude_retweets=true&exclude_replies=true

参数说明:
- username: 用户ID（数字，不是@用户名）
- count: 推文数量 (默认20)
- type: tweets(默认), media, replies
- exclude_retweets: 排除转推 (true/false)
- exclude_replies: 排除回复 (true/false)

✨ 新功能: 自动标记置顶推文
每条推文包含 isPinned 字段标识是否为置顶

获取用户信息

GET /api/user/info?username=用户ID或用户名

示例: /api/user/info?username=44196397
或: /api/user/info?username=elonmusk

获取用户ID（辅助工具）

GET /api/user/id?username=用户名

示例: /api/user/id?username=elonmusk
返回用户ID，可用于timeline接口

获取用户置顶推文

GET /api/user/pinned?username=用户ID&count=数量

示例: /api/user/pinned?username=44196397&count=5
专门获取用户的置顶推文

检查配置状态

GET /api/status

检查API Key配置状态

Guest模式搜索 (无需认证)

GET /api/guest/search?q=搜索词&count=数量

示例: /api/guest/search?q=hello&count=10
注意: Guest模式功能有限

运行时登录获取API Key

POST /api/auth/login

Body: {
  "email": "你的邮箱",
  "username": "你的用户名", 
  "password": "你的密码"
}

成功后会返回API Key，复制保存到.dev.vars文件中

⚙️ 配置

需要设置以下环境变量:

wrangler secret put API_KEY

📝 响应格式

{
  "success": true,
  "data": { ... }
}

简单轻量 | 方便扩展 | 个人使用