RaceIQ APIraceiq.com ↗
Access RaceIQ's full metric catalogue, individual metric guides, and glossary via 3 endpoints. Covers sectional data, stride metrics, jump analytics, and more.
What is the RaceIQ API?
The RaceIQ API exposes 3 endpoints for accessing horse-racing GPS performance metrics published on raceiq.com. Use list_metrics to retrieve the full catalogue of metric codes with their display names and racing-code labels (FLAT or JUMP), then call get_metric_guide with any metric code to get the complete explanatory guide — including ordered sections, bullet points, and embedded video URLs — for metrics like Sectional Data, Stride Data, or Jumping Metrics.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e38f32a6-e9a1-479c-8102-716d23408baf/list_metrics' \ -H 'X-API-Key: $PARSE_API_KEY'
Lists the RaceiQ metrics presented on the metrics overview page, one row per metric. Each row carries the metric code accepted by get_metric_guide, the display name, and the racing code label the site shows on the card (FLAT or JUMP) or null when the card carries no such label. One page fetch; no pagination. Returns 10 metrics at the time of writing.
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer number of metrics returned",
"metrics": "array of metric rows: metric (code for get_metric_guide), name (display title), racing_code (FLAT | JUMP | null)"
},
"sample": {
"data": {
"count": 10,
"metrics": [
{
"name": "Sectional Data",
"metric": "sectional-data",
"racing_code": null
},
{
"name": "0-20mph",
"metric": "0-20mph",
"racing_code": "FLAT"
},
{
"name": "Jump Index",
"metric": "jump-index",
"racing_code": "JUMP"
}
]
},
"status": "success"
}
}About the RaceIQ API
Metric Catalogue
list_metrics returns every metric RaceIQ publishes, along with three fields per row: a metric code (used as the input to get_metric_guide), a human-readable name, and a racing_code label of FLAT, JUMP, or null where no code is assigned. The count field tells you how many metrics the catalogue currently contains. No inputs are required.
Per-Metric Guides
get_metric_guide takes a single required parameter — metric, a code from the catalogue — and returns the full structured content of that metric's guide page. The response includes a title, an optional kicker string (e.g. "A GUIDE TO"), and a sections array. Each section carries a heading, paragraphs (ordered strings), bullets, and a videos array of embedded player URLs where the guide includes video examples. A related_metrics array lists the codes of other metrics linked from that page, making it straightforward to traverse connected topics.
Metrics Glossary
get_metrics_glossary returns all RaceIQ terminology in a single response, grouped into named categories such as Timings Data, Time Analysis, Jumping Metrics, and Stride Data. Each term within a category carries a definition string and a notes array for supplementary bullet points. The term_count field gives the total number of defined terms across all categories. There is no pagination — the full glossary is returned in one call.
The RaceIQ API is a managed, monitored endpoint for raceiq.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when raceiq.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official raceiq.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a reference tool that maps metric codes to plain-English definitions using the glossary
categoriesandterms. - Filter the metric catalogue by
racing_codeto present only FLAT or JUMP metrics to users of a race-analysis app. - Traverse related metrics automatically using the
related_metricsarray returned byget_metric_guide. - Extract embedded video URLs from guide
sectionsto assemble a training library of GPS metric explainers. - Index all metric
nameanddefinitionfields into a search engine for a horse-racing analytics knowledge base. - Generate structured documentation for internal data pipelines by pulling all metric guides in sequence from the catalogue.
- Populate glossary tooltips in a racing dashboard using term
definitionandnotesfields fromget_metrics_glossary.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does RaceIQ offer an official developer API?+
What does `get_metric_guide` return beyond plain text?+
get_metric_guide returns a structured sections array where each section carries a heading, ordered paragraphs, a bullets array, and a videos array of embedded player URLs for any sections that include video examples. It also returns a related_metrics array of metric codes linked from that guide page.Does `list_metrics` distinguish between Flat and Jump racing metrics?+
metrics array includes a racing_code field that is FLAT, JUMP, or null depending on the label the catalogue assigns to that metric card.Does the API return live race results, sectional times for specific races, or horse-level GPS data?+
Is the glossary paginated, and how many terms does it typically cover?+
get_metrics_glossary returns all categories and terms in a single response. The term_count field in the response gives the exact total across all categories at the time of the call.