Tutorials
Learn the API one race at a time.
15 practical lessons covering every live endpoint, the widgets, MCP and the habits that keep your request allowance intact. Real request code in Node, Python and PHP. No sign-in needed to read.
Endpoint map
- /v1/racecardsL2
- /v1/races/{id}L3
- /v1/resultsL4
- /v1/results/{raceId}L4
- /v1/horses/searchL5
- /v1/horses/{id}L5
- /v1/horses/{id}/formL6
- /v1/jockeys/{id}L7
- /v1/trainers/{id}L7
- /v1/racecoursesL8
- /v1/racecourses/{id}L8
- /v1/racecourses/{id}/weatherL8
- /v1/silks/{id}L9
- /v1/odds/{raceId}L10
- /v1/tipsL11
- /v1/races/{raceId}/tipL11
- /v1/races/{raceId}/tip/explanationL11
Curriculum
Five tracks, read in order or jump in.
15 tutorials shown
Foundations
- 01Getting started: keys, a server-side client and your first requestCreate a RacingAPI.net key, keep it on your server, make your first UK and Irish racecards request in Node, Python or PHP, and read the standard response envelope.9 min
/v1/racecards - 02Racecards, dates and pagination: discovering the day's racingUse /v1/racecards to discover UK and Irish races, choose today, tomorrow or a dated feed, page through results correctly and carry IDs into follow-up requests.10 min
/v1/racecards - 03Race details without N+1 callsFetch a single UK or Irish race with /v1/races/{id}, understand nested runners, prices and results, and avoid the N+1 request pattern that wastes allowance.8 min
/v1/races/{id}
Racing data
- 04Results and dividends: finishers, starting prices and wagersList published UK and Irish results with /v1/results, fetch one race with /v1/results/{raceId}, and render finishers, starting prices and source dividend records.9 min
/v1/results/v1/results/{raceId} - 05Horse search and declared horse profilesSearch declared horses by name with /v1/horses/search and fetch a runner profile with /v1/horses/{id}, including weight, connections, form rows and prices.8 min
/v1/horses/search/v1/horses/{id} - 06Horse form statistics: summary rows by sectionRender supplied horse form statistics from /v1/horses/{id}/form: race record, conditions, headgear, class rating and connections, grouped by section.8 min
/v1/horses/{id}/form - 07Jockeys and trainers: daily bookings and connectionsUse /v1/jockeys/{id} and /v1/trainers/{id} to list a jockey's rides or a trainer's runners for one day, with horse-specific connection statistics.7 min
/v1/jockeys/{id}/v1/trainers/{id}
Media and prices
- 08Racecourses and course weather forecastsList courses in a UK and Irish daily feed, open one course with its races, and show attributed course-location weather forecasts from /v1/racecourses/{id}/weather.10 min
/v1/racecourses/v1/racecourses/{id}/v1/racecourses/{id}/weather - 09Racing silks: binary PNG images through your own routeDownload racing-colour PNGs from /v1/silks/{id} with the required raceId, proxy them through your server without exposing your key, and cache them properly.8 min
/v1/silks/{id} - 10Live odds: polling /v1/odds/{raceId} responsiblyRead bookmaker prices with /v1/odds/{raceId}, join them to runners by horse ID, and poll only active races within the five-second shared cache window.9 min
/v1/odds/{raceId}
Products
- 11AI-assisted tips: saved selections, explanations and settlementEnterprise REST tutorial for /v1/tips, /v1/races/{raceId}/tip and its explanation endpoint: statuses, bet types, place terms, settlement and safe display.11 min
/v1/tips/v1/races/{raceId}/tip/v1/races/{raceId}/tip/explanation - 12Widgets and WordPress: saved designs, shortcodes and Shadow DOMDesign a racing widget, register one HTTPS website, install the WordPress plugin with a server-only widget key and place racecards, results or tips with shortcodes.10 min
- 13Connecting AI clients with the Enterprise MCP serverConnect a compatible AI client to the RacingAPI.net Enterprise MCP server through OAuth consent or an API-key header, and understand limits and safety.7 min
Operations
- 14Account, billing, usage, limits and error handlingUnderstand plans, trials, usage headers and HTTP errors on RacingAPI.net, and build a retry helper that honours Retry-After and never loops on 401 or 403.10 min
- 15Saving requests: shared caches, deduplication and budgetsMake RacingAPI.net allowance last: understand the shared server cache, cache by date, deduplicate in-flight requests, poll only active races and estimate budgets.11 min
DiagramHow the lessons fit together
- 1Getting started. Keys, server-side client, envelope.
- 2Racecards. Pick the day, page through races.
- 3Detail endpoints. Races, results, horses, connections, courses.
- 4Silks and odds. Binary images and bounded polling.
- 5Operate. Errors, retries and request budgets.