Kehittäjille

Velofy API

Hae Suomen pyöräilytapahtumat suoraan koodista tai AI-agentista. Kaksi tapaa samaan dataan: tavallinen REST-rajapinta ja MCP-palvelin AI-agenteille. Luo henkilökohtainen API-avain – se kytkeytyy tunnukseesi (seuranta + käyttörajat).

REST-rajapinta

Palauttaa JSON:n. Oletuksena tämän vuoden tulevat tapahtumat.

GET https://www.velofy.cc/api/events

Esimerkki

# Gravel-tapahtumat Helsingin seudulla loppuvuonna
curl "https://www.velofy.cc/api/events?from=2026-08-12&to=2026-12-31&discipline=gravel&city=Helsinki"

Parametrit

Kaikki valinnaisia.

Parametri	Kuvaus
`from`	Alkupäivä `YYYY-MM-DD` (oletus: tänään). Monipäiväinen tapahtuma näkyy jos sen kesto osuu välille.
`to`	Loppupäivä `YYYY-MM-DD` (oletus: kuluvan vuoden loppu).
`discipline`	Laji, pilkku = TAI: `gravel, road, mtb, cx, track, bmx, trial`
`type`	Tyyppi, pilkku = TAI: `race, sportive, mixed, brevet, gravel_camp, bikepacking, social_ride`
`city`	Kaupunki (osittainen haku)
`region`	Maakunta (osittainen haku)
`q`	Hakusana tapahtuman nimestä
`limit`	Enintään N tulosta (oletus 200, max 1000)

Vastaus

{
  "count": 42,
  "events": [
    {
      "id": "kymi-grvl-2026",
      "name": "KYMI GRVL 2026",
      "start_date": "2026-08-15",
      "end_date": null,
      "event_type": "sportive",
      "disciplines": ["gravel"],
      "city": "Kouvola",
      "region": "Kymenlaakso",
      "entry_fee_eur": 40,
      "distances_km": [38, 71, 116],
      "registration_url": "https://my.raceresult.com/391836/",
      "website": "https://kouvolanpyorailijat.wordpress.com/kymi-grvl-2026/",
      "url": "https://www.velofy.cc/events/kymi-grvl-2026/"
    }
  ]
}

Jokaisella tapahtumalla on nämä kentät. null = ei tiedossa. Vastaus on välimuistissa 5 min.

MCP-palvelin (AI-agenteille)

Jos rakennat AI-coachia tai muuta agenttia, liitä Velofy MCP-palvelimena – agentti osaa hakea tapahtumat luonnollisella kielellä. Toimii Claudessa, Cursorissa, Copilotissa ym.

MCP https://www.velofy.cc/api/mcp

Liitä Claude Codeen

claude mcp add --transport http velofy https://www.velofy.cc/api/mcp \
  --header "Authorization: Bearer vlf_…"

Avaimen luot Oma Velofyssä (kirjaudu Googlella). Työkalu list_events ottaa samat suodattimet kuin REST (from, to, discipline, type, city, region, q, limit) ja palauttaa saman kevyen tapahtumalistan.

Mitä data kattaa

Viralliset tapahtumat — kilpailut, kuntoajot, brevet't, leirit ym. koko Suomesta. Valmis käyttöön nyt.
Viikkolenkit ja toistuvat ryhmälenkit — tulossa. Nämä eivät ole vielä rajapinnassa; sisältö on työn alla. Kun ne lisätään, ne löytyvät samasta päätepisteestä.

Reilut pelisäännöt

Avoin, mutta ole kiltti. Ei avainta eikä rajoitteita — mutta rajapinta pyörii pienellä budjetilla. Kunnioita 5 min välimuistia, älä pollaa tiheämmin kuin tarvitset, äläkä hae samaa dataa uudestaan ja uudestaan. Jos rakennat jotain isompaa, laita viestiä — jutellaan.

Data on velofy.cc:n keräämää; lähde kannattaa mainita (linkki url-kenttään tai velofy.cc). Rajapinta voi muuttua — ilmoitamme rikkovista muutoksista tällä sivulla.