如何通过start.gg API获取Smash Ultimate的所有用户？

核心结论 #

start.gg API不提供直接获取所有Smash Ultimate用户的接口，官方文档里确实没有这类全局用户列表的查询入口——API的设计逻辑更偏向围绕赛事、对局等场景，提供特定玩家或赛事关联玩家的查询能力。

替代方案：通过赛事关联获取参赛用户 #

既然你已经能查询法国地区的Smash赛事，可以基于这些赛事数据，进一步获取每个赛事的参赛者信息，再通过去重得到一批活跃用户。这是目前能获取大量相关用户的可行方式。

扩展后的GraphQL查询示例 #

你可以在现有赛事查询的基础上，扩展获取每个赛事的参赛者及关联用户信息：

query TournamentsWithEntrants($perPage: Int!, $videogameId: ID!, $page: Int!) {
  tournaments(query: {
    perPage: $perPage
    page: $page
    filter: {
      past: true
      countryCode: "FR"
      videogameIds: [$videogameId]
    }
  }) {
    pageInfo {
      totalPages
      page
    }
    nodes {
      createdAt
      endAt
      id
      name
      slug
      # 扩展获取赛事参赛者
      entrants(query: { perPage: 100 }) {
        nodes {
          participants {
            user {
              id
              name
              gamerTag
            }
          }
        }
      }
    }
  }
}

注意事项 #

• 分页处理：赛事本身需要分页（循环遍历pageInfo.totalPages，逐页调整page参数），同时每个赛事的entrants也可能需要分页，需根据实际数据量调整perPage并处理分页逻辑
• 速率限制：严格遵守start.gg API的调用频率限制，避免触发限流导致请求失败
• 用户去重：同一个玩家可能参加多个赛事，需要在本地对获取到的用户ID进行去重，避免重复存储数据

内容的提问来源于stack exchange，提问作者Tdnet 59