{ "openapi": "3.0.1", "info": { "title": "MMA Stats Scraper: UFC Fights, Fighters & Rankings", "description": "Extract UFC and MMA fight results, fighter records, and striking and grappling stats across 19 promotions. Structured JSON or CSV output, ready for betting models, fantasy leagues, or fighter databases. Skip manual stats-page digging. Pay per result.", "version": "0.1", "x-build-id": "8SGcYf6pGOXHqpGxI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ufc-mma-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ufc-mma-stats-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/getascraper~ufc-mma-stats-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ufc-mma-stats-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/getascraper~ufc-mma-stats-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ufc-mma-stats-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", "properties": { "mode": { "title": "Mode", "enum": [ "fights", "fighters", "rankings", "events" ], "type": "string", "description": "What kind of rows this run should produce.", "default": "fights" }, "eventIds": { "title": "Event IDs", "type": "array", "description": "Restrict to specific ESPN event IDs. Fastest and most reliable way to target fights mode.", "items": { "type": "string" } }, "fighterIds": { "title": "Fighter IDs", "type": "array", "description": "Limit to particular athlete IDs. Required for fighters mode.", "items": { "type": "string" } }, "promotions": { "title": "Promotions", "type": "array", "description": "MMA promotions to cover.", "items": { "type": "string", "enum": [ "ufc", "pfl", "one", "bellator", "cagewarriors", "ksw", "rizin", "pride", "strikeforce", "wec", "invicta", "lfa", "brave", "acb", "bkfc", "gfl", "contender", "roadfc", "titanfc" ], "enumTitles": [ "UFC", "PFL", "ONE Championship", "Bellator", "Cage Warriors", "KSW", "RIZIN", "PRIDE", "Strikeforce", "WEC", "Invicta FC", "LFA", "Brave CF", "ACB", "BKFC", "GFL", "Contender Series", "Road FC", "Titan FC" ] }, "default": [ "ufc" ] }, "years": { "title": "Years", "type": "array", "description": "Calendar years to cover. Ignored if fromDate/toDate is set.", "items": { "type": "integer" } }, "fromDate": { "title": "From Date", "type": "string", "description": "YYYYMMDD. Overrides years.", "default": "" }, "toDate": { "title": "To Date", "type": "string", "description": "YYYYMMDD. Overrides years.", "default": "" }, "weightClass": { "title": "Weight Class", "type": "string", "description": "Filter by weight class name, e.g. Welterweight.", "default": "" }, "stance": { "title": "Stance", "enum": [ "Orthodox", "Southpaw", "Switch", "Open Stance", "Sideways" ], "type": "string", "description": "Filter fighters by fighting stance." }, "minWins": { "title": "Minimum Wins", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only include fighters with at least this many career wins." }, "minLosses": { "title": "Minimum Losses", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only include fighters with at least this many career losses." }, "resultFilter": { "title": "Result Filter", "type": "array", "description": "Only include bouts with these results.", "items": { "type": "string", "enum": [ "win", "loss", "draw", "nc" ], "enumTitles": [ "Win", "Loss", "Draw", "No Contest" ] } }, "methodFilter": { "title": "Method Filter", "type": "array", "description": "Only include bouts ending by these methods.", "items": { "type": "string", "enum": [ "kotko", "submission", "decision", "other" ], "enumTitles": [ "KO/TKO", "Submission", "Decision", "Other" ] } }, "titleFightsOnly": { "title": "Title Fights Only", "type": "boolean", "description": "Only include championship title bouts.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of dataset rows this run will save.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for ESPN API requests. Datacenter proxy is sufficient.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }