Clipfarm

Teams API

API endpoints for FTC team data


Access information about FIRST Tech Challenge teams.

List teams

GET /v1/teams

Query parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
perPageintegerItems per page (default: 25, max: 100)
seasonstringFilter by active season
regionstringFilter by region/state
searchstringSearch by team name or number

Example

curl "https://api.clipfarm.watch/v1/teams?search=Hivemind"
{
  "data": [
    {
      "number": 23396,
      "name": "Hivemind",
      "school": "Homeschooled",
      "city": "Spring Hill",
      "state": "Tennessee",
      "country": "USA",
      "rookie": 2023,
      "website": "https://hivemindrobotics.net",
      "clipCount": 127
    }
  ],
  "meta": { "page": 1, "perPage": 25, "total": 1 }
}

Get team

GET /v1/teams/:teamNumber
ParameterTypeDescription
teamNumberintegerTeam number (e.g. 23396)
{
  "data": {
    "number": 23396,
    "name": "Hivemind",
    "school": "Homeschooled",
    "location": {
      "city": "Spring Hill",
      "state": "Tennessee",
      "country": "USA"
    },
    "rookie": 2023,
    "website": "https://hivemindrobotics.net",
    "stats": {
      "eventCount": 12,
      "matchCount": 156,
      "clipCount": 127
    }
  }
}

Sub-resources

GET /v1/teams/:teamNumber/events
GET /v1/teams/:teamNumber/matches
GET /v1/teams/:teamNumber/clips
GET /v1/teams/:teamNumber/stats

Clips query parameters

ParameterTypeDescription
eventIdstringFilter by event
seasonstringFilter by season
sortstringSort order (default: -date)

Stats example

{
  "data": {
    "season": "2024-2025",
    "events": 12,
    "matches": 156,
    "wins": 89,
    "losses": 67,
    "winRate": 0.571,
    "avgScore": 127.4,
    "highScore": 214,
    "rankings": {
      "regional": 4,
      "state": 12,
      "world": 156
    }
  }
}

On this page