{ "openapi": "3.0.1", "info": { "title": "Equibase Scraper - Horse Racing Entries, Results & Charts API", "description": "Extract US and Canadian Thoroughbred racing data from Equibase: race entries with jockey, trainer, owner, sire and dam, finished results with win-place-show and exotic payoffs, and horse profiles with career records.", "version": "0.1", "x-build-id": "JnFHmRU4RLzwwJ6Bn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~equibase-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-equibase-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~equibase-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-equibase-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~equibase-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-equibase-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "resultType" ], "properties": { "resultType": { "title": "What to scrape", "enum": [ "entries", "results", "horses" ], "type": "string", "description": "Entries are the horses declared for an upcoming card. Results are the finish order and payoffs of a card that has run. Horses are career profiles.", "default": "entries" }, "tracks": { "title": "Tracks", "type": "array", "description": "Equibase track codes (DMR, SAR, CD, GP…) or full track names (\"Del Mar\"). Leave empty to take every track with a card on the chosen date.", "default": [], "items": { "type": "string" } }, "date": { "title": "Race date", "type": "string", "description": "A single race day as YYYY-MM-DD. Defaults to today for entries, and to each track's most recent card for results." }, "dateFrom": { "title": "Date from", "type": "string", "description": "Start of an inclusive date range, YYYY-MM-DD. Days a track did not race are skipped using its own calendar, so they cost nothing." }, "dateTo": { "title": "Date to", "type": "string", "description": "End of the inclusive date range, YYYY-MM-DD." }, "maxDays": { "title": "Max race days per track", "minimum": 1, "maximum": 60, "type": "integer", "description": "Ceiling on how many race days are fetched per track. Each day is one page load through the anti-bot challenge, so this is the main lever on run time.", "default": 3 }, "country": { "title": "Country", "enum": [ "USA", "CAN", "PUR" ], "type": "string", "description": "Equibase country code in the page URL. USA covers the United States, CAN covers Canadian tracks such as Woodbine.", "default": "USA" }, "horseUrls": { "title": "Horse URLs or reference numbers", "type": "array", "description": "Required when result type is Horse profiles. Accepts a full Equibase horse URL or the bare refno, for example 10068168.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Ceiling on rows written. A ceiling, not a target — a single card returns as many rows as it has runners.", "default": 100 }, "raceNumbers": { "title": "Race numbers", "type": "array", "description": "Keep only these races on the card, for example [1, 2, 9].", "default": [], "items": { "type": "string" } }, "surfaces": { "title": "Surface", "type": "array", "description": "Keep only races on these surfaces.", "items": { "type": "string", "enum": [ "Dirt", "Turf", "All Weather", "Steeplechase" ], "enumTitles": [ "Dirt", "Turf", "All Weather / synthetic", "Steeplechase" ] }, "default": [] }, "minPurse": { "title": "Minimum purse (USD)", "minimum": 0, "type": "integer", "description": "Keep only races with a purse of at least this much." }, "maxPurse": { "title": "Maximum purse (USD)", "minimum": 0, "type": "integer", "description": "Keep only races with a purse of at most this much." }, "onlyStakes": { "title": "Only stakes races", "type": "boolean", "description": "Keep only stakes, handicaps, derbies, cups and graded races.", "default": false }, "onlyClaiming": { "title": "Only claiming races", "type": "boolean", "description": "Keep only races where horses can be claimed.", "default": false }, "breeds": { "title": "Breed", "type": "array", "description": "Keep only these breeds, for example TB for Thoroughbred, QH for Quarter Horse.", "default": [], "items": { "type": "string" } }, "horseName": { "title": "Horse name", "type": "string", "description": "Keep only rows whose horse name contains this text." }, "jockey": { "title": "Jockey", "type": "string", "description": "Keep only rows whose jockey contains this text. Equibase abbreviates first names on entries, so \"Kimura\" beats \"Kazushi Kimura\"." }, "trainer": { "title": "Trainer", "type": "string", "description": "Keep only rows whose trainer contains this text." }, "owner": { "title": "Owner", "type": "string", "description": "Keep only rows whose owner contains this text." }, "sexes": { "title": "Sex", "type": "array", "description": "Keep only horses of these sexes, using Equibase's one-letter codes.", "items": { "type": "string", "enum": [ "C", "F", "G", "H", "M", "R" ], "enumTitles": [ "Colt", "Filly", "Gelding", "Horse", "Mare", "Ridgling" ] }, "default": [] }, "minAge": { "title": "Minimum age", "minimum": 1, "type": "integer", "description": "Keep only horses at least this many years old." }, "maxAge": { "title": "Maximum age", "minimum": 1, "type": "integer", "description": "Keep only horses at most this many years old." }, "excludeScratched": { "title": "Exclude scratched horses", "type": "boolean", "description": "Drop horses Equibase marks as scratched from the card.", "default": false }, "includeConnections": { "title": "Include owners and breeders", "type": "boolean", "description": "Adds the owner and breeder to every runner, and the winning owner, breeder, trainer and jockey to every result. Billed per row that carries them. The jockey and trainer riding each entry are always included and cost nothing extra.", "default": false }, "includePedigree": { "title": "Include pedigree", "type": "boolean", "description": "Adds sire, dam and dam sire to every runner. Billed per row that carries them.", "default": false }, "includeWagers": { "title": "Include exotic payoffs", "type": "boolean", "description": "Adds the exacta, trifecta, superfecta and Pick N payoffs to the winning row of each race. Billed per race that publishes them. Win, place and show payoffs are always included and cost nothing extra.", "default": false }, "includeRaceHistory": { "title": "Include race history", "type": "boolean", "description": "Adds the full past-performance list to each horse profile. Billed per profile that carries one. Career totals, win rate and earnings are always included.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Equibase refuses datacenter addresses, so a residential exit is the default and the Actor will almost certainly be blocked without one. Only turn it off if you are running from an IP Equibase already trusts.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }