{ "openapi": "3.0.1", "info": { "title": "UFC Scraper", "description": "Scrape UFC.com for fighter profiles, event fight cards, and division rankings. Get records, stats, bios, fight results, and pound-for-pound rankings as structured JSON.", "version": "1.1", "x-build-id": "xinSKS34qWr0OKixT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~ufc-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-ufc-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/parsebird~ufc-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-ufc-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/parsebird~ufc-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-ufc-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": [ "dataType" ], "properties": { "dataType": { "title": "What to Extract", "enum": [ "fighters", "events", "rankings" ], "type": "string", "description": "What to collect: fighters (athlete profiles & records), events (fight cards & results), or rankings (official division & pound-for-pound standings).", "default": "fighters" }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Fighter names (for Fighters) or event names (for Events). Each term is searched separately and results are merged. Leave empty to collect everything of the chosen type. Ignored for Rankings.", "default": [], "items": { "type": "string" } }, "division": { "title": "Division", "enum": [ "", "flyweight", "bantamweight", "featherweight", "lightweight", "welterweight", "middleweight", "light-heavyweight", "heavyweight", "womens-strawweight", "womens-flyweight", "womens-bantamweight", "womens-featherweight", "pound-for-pound" ], "type": "string", "description": "Limit to one weight division. Applies to Fighters and Rankings. Women's Featherweight returns Fighters only for now: UFC no longer publishes a Women's Featherweight ranking, so Rankings has no list to return for it.", "default": "" }, "gender": { "title": "Gender", "enum": [ "", "male", "female" ], "type": "string", "description": "Limit to male or female divisions. Applies to Fighters and Rankings.", "default": "" }, "fighterStatus": { "title": "Fighter Status", "enum": [ "", "active", "not-fighting", "retired" ], "type": "string", "description": "Limit to active, not-fighting, or retired. Applies to Fighters only.", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Limit to fighters born in this country, e.g. United States, Brazil, Russia. Applies to Fighters only.", "default": "" }, "eventType": { "title": "Event Type", "enum": [ "all", "upcoming", "past" ], "type": "string", "description": "Collect upcoming events, past events, or all. Applies to Events only.", "default": "all" }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Fetch the complete record per result: striking/grappling stats and bio for fighters, or the full fight card with per-fight results for events. Turn off for a faster, lighter listing-level summary. No effect on Rankings.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "How many records to collect in total across all search terms. Set to 0 to collect as many as possible. You'll get at most this many — fewer when the source has fewer (Rankings always returns one row per division regardless of this value). Very large uncapped sweeps are time-budgeted — Fighters roster runs (with or without full details) and Events calendar runs alike. If a run reaches the budget it stops and returns the records gathered so far, with a note in the log — set a specific number, or narrow with a weight division or event type, for a run that finishes cleanly.", "default": 100 } } }, "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 } } } } } } } } } }