{ "openapi": "3.0.1", "info": { "title": "Sherdog MMA Fighters, Fights & Events Scraper", "description": "MMA fighter profiles with full fight histories, event cards and bout results from Sherdog - UFC, PFL, Bellator, ONE and hundreds of other promotions, back to the 1990s - with incremental runs.", "version": "0.1", "x-build-id": "Yhb7Og2HbD7Tgktff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/artsiom_k~sherdog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-artsiom_k-sherdog-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/artsiom_k~sherdog-scraper/runs": { "post": { "operationId": "runs-sync-artsiom_k-sherdog-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/artsiom_k~sherdog-scraper/run-sync": { "post": { "operationId": "run-sync-artsiom_k-sherdog-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": { "entityType": { "title": "Data type", "enum": [ "fighters", "events", "fights" ], "type": "string", "description": "\"fighters\": one row per fighter with bio, record breakdown (KO/submission/decision), upcoming fights and the full fight history (pro, amateur and exhibition). \"events\": one row per event with its whole card. \"fights\": one flat row per bout (opponents, winner, method, round, time, referee).", "default": "fighters" }, "organizations": { "title": "Promotions", "type": "array", "description": "Limit to these promotions. For events and fights that means their events; for fighters, the fighters on those cards. Leave EMPTY for the entire Sherdog database (about 354,000 fighters and 77,000 events - a very large run). For a promotion not listed, paste its Sherdog /organizations/... URL into Start URLs.", "items": { "type": "string", "enum": [ "ufc", "pfl", "bellator", "one", "dwcs", "tuf", "strikeforce", "wec", "invicta", "ksw", "oktagon", "rizin", "cage-warriors", "lfa", "pancrase", "shooto", "deep", "aca", "brave-cf", "titan-fc", "road-fc", "fng", "kotc", "boxing" ], "enumTitles": [ "UFC", "PFL", "Bellator MMA", "ONE Championship", "Dana White's Contender Series", "The Ultimate Fighter", "Strikeforce", "WEC", "Invicta FC", "KSW", "Oktagon MMA", "Rizin FF", "Cage Warriors", "Legacy Fighting Alliance (LFA)", "Pancrase", "Shooto", "DEEP", "ACA", "Brave CF", "Titan FC", "Road FC", "Fight Nights Global", "King of the Cage", "Boxing" ] }, "default": [ "ufc" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional specific Sherdog URLs: fighter pages (https://www.sherdog.com/fighter/Jon-Jones-27944), event pages (.../events/UFC-309-Jones-vs-Miocic-103896) or promotion pages (.../organizations/Ultimate-Fighting-Championship-UFC-2). When set, they replace the promotion selection. A run with Start URLs never updates the incremental memory.", "items": { "type": "string" } }, "dateFrom": { "title": "Events from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only events on or after this date (events and fights; for fighters, those on matching cards). Fast with a promotion selected; with none it filters after fetching every event." }, "dateTo": { "title": "Events to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only events on or before this date. Use a future date range to get upcoming cards." }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after pushing this many rows. Defaults to 50 - a fast, cheap preview, and what keeps an unconfigured run within Apify's automated 5-minute QA check. Set to null for everything in your selection.", "default": 50 }, "mode": { "title": "Incremental mode", "enum": [ "auto", "full", "incremental" ], "type": "string", "description": "Applies to \"events\" and \"fights\" only. \"auto\": the first run returns everything in scope; later runs, with maxItems cleared, return only new events and events whose card or results changed in the last 90 days (or upcoming) - older events are history and are not repeated. A capped run (the default preview) always returns rows. \"fighters\" is always a fresh pull.", "default": "auto" }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "Parallel page requests (max 25).", "default": 8 }, "impersonate": { "title": "TLS impersonation target", "type": "string", "description": "curl_cffi browser TLS-impersonation target. Defaults to \"firefox\" internally; change only if requests are blocked." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Not needed: Sherdog answered every request from Apify's infrastructure in testing without a proxy.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }