GTA数据库开放API

GTA数据库开放API

缓存规则
30 分钟 / 5 折优惠
同一玩家 30min 内重复查询仅扣半价
认证方式
Bearer Token
Header: Authorization: Bearer <KEY>
数据接口目录

玩家精准/模糊搜索 (Search)

GET
/api/v1/rockstar/player/search

支持通过玩家 Rockstar 昵称、Xbox 玩家代号或 PSN ID 进行全网搜索，重点输出玩家唯一的 R 星数字 ID、头像、帮会以及绑定的全部第三方平台账号（Xbox / PSN 等）。

请求参数 (Query Parameters)

参数名类型必填说明示例
qstring是搜索关键词 (玩家昵称、主机ID或前缀)Dinghy-421
refreshboolean否设为 1 或 true 强制跳过缓存向源站抓取false
curl -X GET "https://www.antwen.cn/api/v1/rockstar/player/search?q=Dinghy-421" \
  -H "Authorization: Bearer gta_live_sk_your_api_key_here"

标准响应示例 (JSON 200 OK)

{
  "code": 200,
  "success": true,
  "data": {
    "query": "Dinghy-421",
    "total_results": 1,
    "has_more": false,
    "players": [
      {
        "rockstar_id": 187831893,
        "nickname": "DINGHY-421",
        "avatar_url": "https://prod-avatars.akamaized.net/stock-avatars/n/GTAO/GTAO_CBFR_Avatar_Chicken_Deliv.png",
        "linked_accounts": [
          {
            "service": "xbox",
            "service_name": "Xbox Live",
            "nickname": "Dinghy421"
          }
        ],
        "primary_crew": {
          "id": 76046116,
          "name": "LCFY CLUB",
          "tag": "LCFY",
          "color": "#00FFFF",
          "member_count": null
        }
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v1/rockstar/player/search",
    "cached": false,
    "cost_amount": 0.03,
    "cost_ms": 2150,
    "balance_remaining": 8.59
  }
}

在线实时沙盒测试 (Live Sandbox)