Race Finder 技能

搜索美国及全球范围内的即将举行的赛事。数据来源于 RunSignUp —— 全球最大的耐力赛事报名平台。

API

基础 URL： https://api.racefinder.net

搜索赛事

GET /api/v1/races

所有参数均为可选。返回按日期排序的即将举行的赛事。

查询参数

Sport 可选值

Distance 可选值

响应格式

{
  "races": [
    {
      "id": "12345",
      "name": "Austin Marathon",
      "date": "2026-03-15",
      "start_time": "7:00 AM",
      "sport": "running",
      "city": "Austin",
      "region": "Texas",
      "country": "US",
      "distances": [
        {"name": "Marathon", "miles": 26.2, "km": 42.2, "category": "marathon"},
        {"name": "Half Marathon", "miles": 13.1, "km": 21.1, "category": "half-marathon"}
      ],
      "prices": [
        {"name": "Marathon — $120", "price": 120, "currency": "USD", "available": true}
      ],
      "image_url": "https://...",
      "details_url": "https://racefinder.net/race/12345",
      "register_url": "https://runsignup.com/Race/12345?rsu_aff=..."
    }
  ],
  "page": 1,
  "total_results": 20
}

无需身份认证。

示例

查找某城市的赛事

curl "https://api.racefinder.net/api/v1/races?city=Austin&state=TX"

查找某邮政编码附近的马拉松赛事

curl "https://api.racefinder.net/api/v1/races?zipcode=78701&radius=50&distance=marathon"

查找今年夏季科罗拉多州的越野跑赛事

curl "https://api.racefinder.net/api/v1/races?state=CO&sport=trail&start_date=2026-06-01&end_date=2026-08-31"

按赛事名称搜索

curl "https://api.racefinder.net/api/v1/races?q=Ironman"

查找加利福尼亚州的 5K 赛事

curl "https://api.racefinder.net/api/v1/races?state=CA&sport=running&distance=5k"

Agent 使用建议

• 当用户希望了解某场赛事更多详情时，请使用 details_url —— 它将跳转至 racefinder.net 上该赛事的完整页面
• 当用户准备报名参赛时，请使用 register_url —— 它将直接跳转至报名页面
• 默认搜索返回从今日起即将举行的赛事，并按日期升序排列
• 组合使用 zipcode 和 radius 进行基于地理位置的搜索（仅限美国）
• 组合使用 sport 和 distance 精确筛选结果（例如：sport=running&distance=half-marathon）
• total_results 字段表示当前页返回的结果总数；可通过 page 参数进行分页