xcontest.org APIxcontest.org ↗
Access XContest.org flight scores, pilot rankings, and contest data for paragliding and hang-gliding via a structured API. Covers UK and worldwide competitions.
curl -X GET 'https://api.parse.bot/scraper/6c570215-015c-4675-882e-68d090b75dc7/get_uk_daily_score_pg?date=last&limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches UK daily paragliding (PG) flight scores for a specific date. Returns a paginated list of flights sorted by points descending.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format or 'last' for the most recent scoring day. |
| limit | integer | Maximum number of flight results to return. |
| start | integer | Zero-based start index for pagination. |
{
"type": "object",
"fields": {
"list": "object containing pagination metadata (startItemIndex, numberItemsRequested, numberItemsReturned, numberItems)",
"items": "array of flight objects with id, ident, pilot, league, glider, takeoff, and route details"
},
"sample": {
"data": {
"list": {
"numberItems": 1,
"startItemIndex": 0,
"numberItemsReturned": 1,
"numberItemsRequested": 5
},
"items": [
{
"id": 6449739,
"type": 1,
"ident": "Webbie/30.04.2026/18:23",
"pilot": {
"id": 78370,
"name": "THOMAS WEBB",
"username": "Webbie",
"countryIso": "GB"
},
"glider": {
"name": "GIN GLIDERS Leopard",
"classFAI": 3
},
"takeoff": {
"name": "?",
"countryIso": "GB"
}
}
]
},
"status": "success"
}
}About the xcontest.org API
This API exposes 9 endpoints covering XContest.org paragliding and hang-gliding competition data, including daily flight leaderboards, pilot profiles, season rankings, and contest listings. The get_uk_flight_detail endpoint returns per-flight stats such as duration, maximum altitude, tracklog distance, glider info, and route scoring. Endpoints cover both UK-specific data and worldwide daily scores, with pagination supported across all list responses.
Flight Scores and Leaderboards
The get_uk_daily_score_pg and get_uk_daily_score_hg endpoints return paginated daily flight scores for UK paragliding and hang-gliding respectively. Both accept a date parameter in YYYY-MM-DD format or the string 'last' to retrieve the most recent scoring day. Each item in the response includes a flight id, ident, pilot details, glider information, takeoff location, and route data, sorted by points descending. The limit and start parameters control pagination across the full result set. get_world_daily_score_pg provides the same structure for global paragliding flights but is limited to the current season year and returns up to 100 flights without configurable pagination.
Pilot Profiles and Rankings
get_uk_pg_ranking returns season standings with fields for rank, points, inScore, pilot identity (id, username, name, countryIso), and league details. The category parameter accepts at minimum 'open'; other category identifiers may be available depending on the current season. get_uk_pilots_list provides a registered-pilot roster with rank, name, username, num_flights, points, and registration_date. A search parameter exists but may not filter reliably in all cases. For a specific pilot, get_uk_pilot_detail takes a numeric pilot_id and returns a full profile including rankings, stats, records, club membership, and current glider.
Flight Detail and Contest Discovery
get_uk_flight_detail accepts either a numeric flight_id or a string flight_ident in username/DD.MM.YYYY/HH:MM format, both of which appear in daily score responses. The returned object includes stats (duration, altitudeMax, distanceTracklog), glider, takeoff, and a league object covering route, competition, and scoring breakdown. Joint flights are also returned where applicable. get_national_contests_list enumerates all national, regional, club, and event contests worldwide, returning each contest's name, url, category, and an is_new flag. get_uk_rules returns the full UK rules text as a plain string including scoring formula, handicap tables, and entry requirements.
Pagination Behavior
All list endpoints return a list metadata object alongside the items array. This object contains startItemIndex, numberItemsRequested, numberItemsReturned, and numberItems (total count), allowing clients to implement standard offset pagination. The pilots list increments in steps of 50, and the start parameter is zero-based across all paginated endpoints.
- Build a daily leaderboard dashboard tracking UK paragliding scores by date using
get_uk_daily_score_pg. - Monitor a specific pilot's season ranking and flight records by combining
get_uk_pg_rankingwithget_uk_pilot_detail. - Aggregate worldwide daily paragliding scores from
get_world_daily_score_pgto compare international performance. - Index all active national and regional XContest competitions using
get_national_contests_listfor a contest discovery tool. - Retrieve per-flight tracklog metadata — altitude, distance, duration — from
get_uk_flight_detailfor post-flight analysis. - Display glider and handicap information alongside pilot stats by cross-referencing
get_uk_pilot_detailandget_uk_rules. - Build a hang-gliding score tracker that queries
get_uk_daily_score_hgwith the'last'date parameter to stay current.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does XContest.org offer an official developer API?+
What does `get_uk_flight_detail` return beyond basic flight info?+
get_uk_flight_detail returns a stats object with duration, altitudeMax, and distanceTracklog; a glider object; a takeoff location object; a league object containing route geometry and scoring breakdown; and joint flight references where the flight was flown alongside other pilots. You can look up a flight by numeric flight_id or by the string flight_ident formatted as username/DD.MM.YYYY/HH:MM.Does the pilot search filter in `get_uk_pilots_list` always work as expected?+
search parameter may not filter reliably in all cases — this is a known limitation. For consistent results when looking up a specific pilot, retrieve their numeric ID from the pilots list and call get_uk_pilot_detail directly.Does the API cover XContest competitions outside the UK, such as other national contest leaderboards?+
get_national_contests_list.Are historical seasons covered, or only the current season?+
get_world_daily_score_pg endpoint explicitly only returns flights from the current season year. UK score endpoints accept a date parameter, so past dates within the available data range can be queried, but multi-season historical archives are not explicitly scoped. If multi-season coverage is needed, you can fork this API on Parse and revise it to parameterize season selection.