# parkrun.com API: Get parkrun event results

> Gets the latest or a dated public parkrun event result, with finishers in position order. If a name matches several events, the closest directory name match is used.

Unofficial. Not affiliated with or endorsed by parkrun.com.

- Page: https://fous.com/methods/parkrun.com/get-event-results
- Method: `parkrun.com/get_event_results`, version 1
- Website: parkrun.com
- Returns: event name, date, run number, finisher count, results page link, runners (position, name, time, age category, age grade, gender, club, note, profile link)
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-19"` | Run date in YYYY-MM-DD format, for example 2026-09-19. Defaults to the latest run. |
| `event` | string | yes | `"Bushy"` | Name of the parkrun, for example Bushy or Albert Park. |
| `max_results` | integer | no | `2000` | Maximum number of finishing runners to return, for example 100. Defaults to 500. Default 500. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "date": "2026-09-19",
  "event": "Bushy",
  "max_results": 2000
}
```

Its output:

```json
{
  "date": "2026-09-19",
  "runners": [
    {
      "club": null,
      "note": null,
      "time": "15:29",
      "gender": "Male",
      "position": 1,
      "runner_name": "Dylan EVANS",
      "age_category": "SM30-34",
      "time_seconds": 929,
      "runner_page_link": "https://www.parkrun.org.uk/bushy/parkrunner/2748711",
      "age_grade_percent": 84.28,
      "parkrunner_number": 2748711
    },
    {
      "club": "Stadium Runners",
      "note": "First Timer!",
      "time": "15:52",
      "gender": "Male",
      "position": 2,
      "runner_name": "Luc BURNIP",
      "age_category": "SM25-29",
      "time_seconds": 952,
      "runner_page_link": "https://www.parkrun.org.uk/bushy/parkrunner/901692",
      "age_grade_percent": 81.3,
      "parkrunner_number": 901692
    },
    {
      "club": null,
      "note": null,
      "time": "16:02",
      "gender": "Male",
      "position": 3,
      "runner_name": "Tom LOVEGROVE",
      "age_category": "VM35-39",
      "time_seconds": 962,
      "runner_page_link": "https://www.parkrun.org.uk/bushy/parkrunner/76094",
      "age_grade_percent": 83.26,
      "parkrunner_number": 76094
    }
  ],
  "event_name": "Bushy parkrun",
  "run_number": 1108,
  "results_page_link": "https://www.parkrun.org.uk/bushy/results/2026-09-19/",
  "number_of_finishers": 1591
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"parkrun.com/get_event_results","input":{"date":"2026-09-19","event":"Bushy","max_results":2000}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Who finished first at Bushy parkrun this past Saturday, and what was their time?
- Pull the full results for Albert Park parkrun on 2025-03-15 — I need every finisher with age grade and club.
- Show me the top 50 finishers from the latest Hackney Marshes run on parkrun.com.
- I ran Newy parkrun on 2024-11-02; can you get the results list so I can find my position and age category?
- Fetch the most recent parkrun.com results for Cannon Hill, limited to the first 100 runners, including run number and total finisher count.

## Input schema

```json
{
  "type": "object",
  "required": [
    "event"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Run date in YYYY-MM-DD format, for example 2026-09-19. Defaults to the latest run."
    },
    "event": {
      "type": "string",
      "description": "Name of the parkrun, for example Bushy or Albert Park."
    },
    "max_results": {
      "type": "integer",
      "default": 500,
      "maximum": 2000,
      "minimum": 1,
      "description": "Maximum number of finishing runners to return, for example 100. Defaults to 500."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "event_name",
    "date",
    "run_number",
    "number_of_finishers",
    "results_page_link",
    "runners"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date"
    },
    "runners": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "runner_name",
          "time",
          "age_category",
          "age_grade_percent",
          "gender",
          "club",
          "note",
          "runner_page_link",
          "time_seconds",
          "parkrunner_number"
        ],
        "properties": {
          "club": {
            "type": [
              "string",
              "null"
            ]
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          },
          "time": {
            "type": [
              "string",
              "null"
            ]
          },
          "gender": {
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "type": "integer"
          },
          "runner_name": {
            "type": "string"
          },
          "age_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "time_seconds": {
            "type": [
              "integer",
              "null"
            ],
            "x-fous-developer": true
          },
          "runner_page_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "age_grade_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "parkrunner_number": {
            "type": [
              "integer",
              "null"
            ],
            "x-fous-developer": true
          }
        },
        "additionalProperties": false
      }
    },
    "event_name": {
      "type": "string"
    },
    "run_number": {
      "type": "integer"
    },
    "results_page_link": {
      "type": "string"
    },
    "number_of_finishers": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
```

## See more

- [UFC API: List events](https://fous.com/methods/ufc.com/list-events.md): Lists upcoming or past UFC events with fight cards, venue, start time and completed bout results, or returns one event by name. Upcoming events come soonest first and past events newest first.
- [Premier League API: Get fixtures and results](https://fous.com/methods/premierleague.com/get-fixtures-and-results.md): Gets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
- [Product Hunt API: List daily launches](https://fous.com/methods/producthunt.com/list-launches.md): Lists featured launches in Product Hunt's daily leaderboard order for a given US Pacific day, with each product's website when its public page shows one.
- [Meetup API: Search events](https://fous.com/methods/meetup.com/search-events.md): Finds upcoming public Meetup events by topic and city, sorted by start time. Only events that mention the topic are included; external costs and undisclosed venues may not be shown.
- [Formula 1 API: Get race results](https://fous.com/methods/formula1.com/get-race-results.md): Returns the main-race finishing order and fastest lap for a Formula 1 Grand Prix. Defaults to the most recent completed race in the current season.
- [NASA API: List natural events](https://fous.com/methods/nasa.gov/list-natural-events.md): List EONET natural events with latest observations in the past number of days, most recent first. A country or region filter matches reported event locations against mapped boundaries; locations and ongoing status are approximate, and not all events have a reported size or strength.
- [Eventbrite API: Search events](https://fous.com/methods/eventbrite.com/search-events.md): Finds public Eventbrite events in a city or online, with optional keywords, date range, category and free-only filtering, ordered by start time.
- [Songkick API: Search concerts in a city](https://fous.com/methods/songkick.com/search-concerts.md): Finds upcoming concerts in a city between two dates on Songkick. Each concert includes its artists, venue, festival name and ticket link.
