Buy Twitter Accounts Developer API v2
返回商城
RESTful Developer API v2

API 开放接口集成文档

通过 RESTful API 快速将推特账号自动出卡、库存查询和余额扣款集成至您的独立站点、ERP 软件或 Telegram 自动发卡机器人。

API 密钥管理 (API Key)

调用凭证与鉴权

在此处填入您的 Key，页面中所有的 GET 示例链接将自动填充并可直接点击新窗口发起调用。

IP 白名单防护 (IP Whitelist)

可选安全配置

填入允许发起 API 请求的服务器公网 IP 地址（每行一个）。留空则表示允许所有公网 IP 调用。

开放接口端点 (Endpoints)

标准 HTTP RESTful 协议，支持通过 Header X-API-KEY 或 Query 参数 ?api_key= 进行鉴权。

1. 获取账户信息与余额 (Get Account Info) GET 
{
  "success": true,
  "user": {
    "email": "user@gmail.com",
    "balance": 25.00
  }
}
2. 获取推特账号在售列表与实时库存 (Get Products List) GET 
{
  "success": true,
  "count": 12,
  "products": [
    {
      "product_id": "prd_x_aged_2022",
      "name": "Twitter (X) 2022 年老号 [带粉丝+带Cookie]",
      "category": "Twitter Accounts",
      "price": 2.50,
      "available_qty": 85,
      "in_stock": true
    }
  ]
}
3. 获取单品规格详情 (Get Product Details) GET

将参数中的 PRODUCT_ID 替换为商品列表中对应的 product_id。

{
  "success": true,
  "product": {
    "product_id": "prd_x_aged_2022",
    "name": "Twitter (X) 2022 年老号",
    "category": "Twitter Accounts",
    "price": 2.50,
    "available_qty": 85,
    "max_per_order": 100,
    "description": "2022年注册优质老号，已绑定原生邮箱，附带全套登录Token"
  }
}
4. 自动扣费购买并即时出卡 (Purchase Product) POST
参数字段 类型 说明
product_id string 所购推特账号的规格唯一 ID (必填)
amount integer 单次购买数量 (10 ~ 100，默认 10)
api_key string 可选，亦可在 Header 中通过 X-API-KEY 传递

以 JSON 请求体发送 POST 请求，系统将自动验证账户余额并瞬间出卡返回卡密。

{
  "success": true,
  "order": {
    "order_id": "ord_88f9104c92",
    "order_uid": "#73918502",
    "product": "Twitter (X) 2022 年老号",
    "quantity": 1,
    "total_price": 2.50,
    "status": "completed",
    "credentials": "username:password:email:emailpass:auth_token",
    "created_at": "2026-09-21T09:30:00.000Z"
  }
}
5. 分页查询历史订单记录 (List Recent Orders) GET 
{
  "success": true,
  "count": 2,
  "total": 18,
  "limit": 10,
  "offset": 0,
  "orders": [
    {
      "order_id": "ord_88f9104c92",
      "order_uid": "#73918502",
      "product_id": "prd_x_aged_2022",
      "product_name": "Twitter (X) 2022 年老号",
      "quantity": 1,
      "total_price": 2.50,
      "status": "completed",
      "credentials": "username:password:email:emailpass:auth_token",
      "created_at": "2026-09-21T09:30:00.000Z"
    }
  ]
}
6. 凭订单号取回订单卡密详情 (Get Order Details) GET

将参数中的 ORDER_ID 替换为购买时返回的订单号。

{
  "success": true,
  "order": {
    "order_id": "ord_88f9104c92",
    "order_uid": "#73918502",
    "product_name": "Twitter (X) 2022 年老号",
    "quantity": 1,
    "total_price": 2.50,
    "status": "completed",
    "credentials": "username:password:email:emailpass:auth_token",
    "created_at": "2026-09-21T09:30:00.000Z"
  }
}
7. 查询钱包余额与充值消费汇总 (Get Wallet Stats) GET 
{
  "success": true,
  "wallet": {
    "current_balance": 25.00,
    "total_spent": 12.50,
    "total_deposits": 37.50
  }
}
安全集成建议 (Security Best Practices)

推荐在自动化脚本或后端中，使用 HTTP Header X-API-KEY: YOUR_KEY 进行鉴权，避免将密钥直接暴露在 URL 地址中被反向代理或日志截获。 

curl -X GET "https://buytwitteraccounts.store/api/v2/products" \
  -H "X-API-KEY: YOUR_API_KEY"

统一错误响应规范 (Error Format)

当请求失败或鉴权未通过时，接口统一返回规范的 JSON 格式：

{"success": false, "error": "Human-readable error description"}
400 Bad Request: 参数缺失或余额不足
401 Unauthorized: 密钥缺失或无效
403 Forbidden: IP 白名单受限
404 Not Found: 商品或订单不存在
502 Bad Gateway: 交付通道维护或超时