# UFC API (AI Fighting Intelligence Engine) (`visita/fighting-intelligence-engine`) Actor The most comprehensive MMA data & AI prediction API on Apify. Get real-time UFC fight cards, official rankings, fighter stats, head-to-head comparisons, AI-powered fight predictions, premium fantasy H2H analysis, and breaking combat sports news — all as clean, structured JSON. - **URL**: https://apify.com/visita/fighting-intelligence-engine.md - **Developed by:** [Visita Intelligence](https://apify.com/visita) (community) - **Categories:** News, AI, Developer tools - **Stats:** 24 total users, 2 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 api results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Fighting Intelligence Engine đŸĨŠ **The most comprehensive MMA data & AI prediction API on Apify.** Get real-time UFC fight cards, official rankings, fighter stats, head-to-head comparisons, AI-powered fight predictions, premium fantasy H2H analysis, and breaking combat sports news — all as clean, structured JSON. ### đŸ”Ĩ What You Get | Query | Description | |---|---| | **Upcoming Events & Fight Cards** | Full fight card for every upcoming UFC event | | **Head-to-Head Comparison** | Side-by-side career stats for any two fighters | | **Fighter Profile** | Win/loss record, weight class, reach, and career highlights | | **Current Rankings** | Official UFC Top 15 for every weight division | | **Weight Class Leaders** | Statistical leaders across all divisions | | **Recent Events** | Results and stats from recently completed events | | **Latest MMA News** | Aggregated headlines from top combat sports outlets, enriched by AI with key entities and sentiment | | **🧠 AI Fight Predictions** | Decision Engine predictions for every bout on the next event using GPT-5.1 — refreshed daily | | **🎮 Fantasy H2H Analysis** | Premium on-demand AI breakdown between any two fighters with fantasy scores, projected stats using GPT-5.1 | ### ⚡ Quick Start 1. Run the Actor with default settings to get **Upcoming Events & Fight Cards** instantly. 2. Select a different **Operation Mode** from the dropdown to access predictions or fantasy analysis. 3. For **Fighter Profile**, enter a name (e.g. `Jon Jones`) in the **Fighter Name** field. 4. For **Head-to-Head** or **Fantasy H2H**, enter both fighters in the **Fighter A** and **Fighter B** fields. > **💡 Typo-tolerant.** Don't worry about exact spelling — the engine uses fuzzy matching to auto-correct fighter names. Type "John Jones" and it will find "Jon Jones" automatically. ### 📊 Output Results are delivered as structured JSON to the Apify dataset. Every response includes: ```json { "query_type": "upcoming_events", "data": [ ... ] } ```` ### 🔍 Available API Queries #### Upcoming Events & Fight Cards Returns all scheduled UFC events with full fight card details including matchups and title fight indicators. #### Compare Fighters (Head-to-Head) Enter two fighter names and receive a side-by-side breakdown of career statistics including significant strikes, takedown accuracy, and fight history. #### Fighter Profile Look up any fighter by name. Returns their full record, weight class, physical stats, and recent performance. #### Current Rankings Get the official UFC Top 15 rankings for every weight class — updated weekly. #### Weight Class Leaders See who leads each division in key statistical categories. #### Recent Events (Completed) Browse results from recent UFC events including fight outcomes, methods of victory, and round-by-round statistics. #### Latest MMA News Aggregated news feed from the top MMA journalism outlets, sorted by recency. ### 🏗ī¸ Modes of Operation | Mode | Description | Billing | |---|---|---| | `api_query` | **Default.** Query the data API for fighter stats, events, rankings, and news. | $0.02 per result | | `predict_event` | 🧠 AI-powered fight predictions for the next upcoming event. Predictions are refreshed daily by the Decision Engine with the latest news context. | $0.15 per query | | `fantasy_h2h` | 🎮 **Premium.** On-demand deep AI analysis between any two fighters using a top-tier model. Includes striking/grappling/cardio breakdown, fantasy scores, projected stats, and Fight of the Night probability. | $0.35 per analysis | ### 🧠 Decision Engine (AI Predictions) The Decision Engine generates fight predictions by combining: - **Statistical modeling** — SLpM, takedown accuracy, win methods, absorption rates - **Common opponent triangulation** — comparing how both fighters performed against shared opponents - **Round-by-round tendencies** — identifying faders vs. late-round surges - **Contextual intelligence** — real-time news about injuries, camp changes, weight-cut issues - **Head-to-head matchup analysis** — comparing statistical advantages across striking, grappling, and durability Predictions are **regenerated daily** so information stays fresh right up to fight night. Users querying on different days may see updated predictions as new intelligence surfaces. ### 🎮 Fantasy H2H (Premium AI Analysis) For fantasy sports players and serious MMA analysts. Pick **any two fighters** and receive: - **Striking, Grappling, Cardio & Intangibles breakdown** with edge attribution - **Common Opponent Triangulation** — detailed comparison of shared opponents - **Stylistic Verdict** — how the styles interact and what decides the fight - **Fantasy Score** (1-100) for each fighter's expected statistical output - **Projected Stats** — significant strikes, takedowns, submission attempts, knockdowns - **Fight of the Night Probability** (0-100%) - **Confidence-weighted prediction** with method Powered by a premium AI model (GPT-5.1 — configurable via `PREMIUM_MODEL` env var). ### 💰 Pricing (Pay-Per-Event) | Event | Description | Price | |---|---|---| | `apify-default-dataset-item` | Standard API data query result | **$0.02** | | `fight-prediction-result` | AI fight prediction (full event card) | **$0.15** | | `ai-h2h-analysis` | Premium fantasy H2H analysis | **$0.35** | > **Spending limits.** Users can set a maximum spend via `ACTOR_MAX_TOTAL_CHARGE_USD`. The engine respects these limits and stops gracefully when reached. ### 🛡ī¸ Admin Operations (Internal Sync) > ℹī¸ **End Users: Ignore this section.** This is used internally to keep the API database up to date. For data pipeline operators, there are two scheduled tasks that run daily to keep the underlying database synchronized: - **Daily System Sync** — A fully automated pipeline that checks for completed events, conditional rankings updates, and fetches the latest news. - **Decision Engine Sync** — Regenerates AI fight predictions utilizing the latest news context and fighter stats. These run automatically behind the scenes so the data is always fresh when you query the API. ### 💡 Use Cases - **Sports Betting Analytics** — Build models with historical fight stats, AI predictions, and head-to-head data - **Fantasy MMA** — Power your fantasy league with premium AI analysis, projected stats, and fantasy scores - **Content & Journalism** — Auto-generate fight previews, stat breakdowns, and AI-powered predictions - **Data Science** — Analyze fighting styles, trends, and career trajectories across weight classes - **Mobile & Web Apps** — Serve structured UFC data and AI predictions to your frontend via Apify API ### 📡 Integration Use this Actor like any standard Apify API: ```bash ## Get upcoming events curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \ -d '{"mode": "api_query", "query_type": "upcoming_events"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN" ## Get AI fight predictions curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \ -d '{"mode": "predict_event"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN" ## Fantasy H2H analysis curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \ -d '{"mode": "fantasy_h2h", "fighter_a": "Jon Jones", "fighter_b": "Tom Aspinall"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN" ``` Results are available in the **Dataset** tab after each run, or programmatically via the Apify API and client libraries (Python, JavaScript, etc.). ### đŸ“Ŧ Support Have a feature request or found a bug? Open an issue on the [GitHub repository](https://github.com/MisterSeitz/fighting-intelligence-engine) or reach out via Apify. # Actor input Schema ## `mode` (type: `string`): Select the task (Billed Operations). ## `query_type` (type: `string`): Select query ## `fighter_name` (type: `string`): Enter the name of a fighter (e.g. 'Jon Jones') for Fighter Profile API. ## `fighter_a` (type: `string`): First fighter for Head-to-Head stats (e.g. 'Jon Jones'). ## `fighter_b` (type: `string`): Second fighter for Head-to-Head stats (e.g. 'Stipe Miocic'). ## `news_limit` (type: `integer`): How many recent news articles to fetch for 'Latest MMA News' query. ## `num_events` (type: `integer`): How many upcoming events to get predictions for (predict\_event mode). Default 1 = next event only. ## `admin_daily_sync` (type: `boolean`): Smart 6-stage pipeline: roster, upcoming events, event completion, conditional rankings (only after fights complete), news, AI news enrichment. Schedule daily. ## `admin_decision_sync` (type: `boolean`): Regenerates AI fight predictions for ALL upcoming events using latest news and stats. Schedule daily, 30 min after Daily Sync. ## `target_org` (type: `string`): Select Organization ## Actor input object example ```json { "mode": "api_query", "query_type": "upcoming_events", "news_limit": 10, "num_events": 1, "admin_daily_sync": false, "admin_decision_sync": false, "target_org": "UFC" } ``` # Actor output Schema ## `api_results` (type: `string`): Structured API query results — fighter stats, rankings, events, and news. ## `predictions` (type: `string`): AI-generated fight predictions for the next upcoming event. ## `fantasy_h2h` (type: `string`): Premium AI head-to-head analysis with fantasy scores and projected stats. ## `full_json` (type: `string`): The complete, raw dataset in JSON format. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("visita/fighting-intelligence-engine").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("visita/fighting-intelligence-engine").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call visita/fighting-intelligence-engine --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=visita/fighting-intelligence-engine", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UFC API (AI Fighting Intelligence Engine)", "description": "The most comprehensive MMA data & AI prediction API on Apify. Get real-time UFC fight cards, official rankings, fighter stats, head-to-head comparisons, AI-powered fight predictions, premium fantasy H2H analysis, and breaking combat sports news — all as clean, structured JSON.", "version": "0.0", "x-build-id": "tIKlNSfHL2KH4FxHh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/visita~fighting-intelligence-engine/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-visita-fighting-intelligence-engine", "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/visita~fighting-intelligence-engine/runs": { "post": { "operationId": "runs-sync-visita-fighting-intelligence-engine", "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/visita~fighting-intelligence-engine/run-sync": { "post": { "operationId": "run-sync-visita-fighting-intelligence-engine", "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": [ "mode" ], "properties": { "mode": { "title": "⚙ī¸ Operation Mode", "enum": [ "api_query", "predict_event", "fantasy_h2h" ], "type": "string", "description": "Select the task (Billed Operations).", "default": "api_query" }, "query_type": { "title": "🔍 API Query Type", "enum": [ "upcoming_events", "fighter_head_to_head", "latest_news", "current_rankings", "fight_predictions", "fighter_profile", "weight_class_leaders", "recent_events" ], "type": "string", "description": "Select query", "default": "upcoming_events" }, "fighter_name": { "title": "👤 Fighter Name", "type": "string", "description": "Enter the name of a fighter (e.g. 'Jon Jones') for Fighter Profile API." }, "fighter_a": { "title": "đŸĨŠ Fighter A", "type": "string", "description": "First fighter for Head-to-Head stats (e.g. 'Jon Jones')." }, "fighter_b": { "title": "đŸĨŠ Fighter B", "type": "string", "description": "Second fighter for Head-to-Head stats (e.g. 'Stipe Miocic')." }, "news_limit": { "title": "📰 Number of News Articles", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent news articles to fetch for 'Latest MMA News' query.", "default": 10 }, "num_events": { "title": "📊 Number of Events", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many upcoming events to get predictions for (predict_event mode). Default 1 = next event only.", "default": 1 }, "admin_daily_sync": { "title": "🚀 Daily System Sync", "type": "boolean", "description": "Smart 6-stage pipeline: roster, upcoming events, event completion, conditional rankings (only after fights complete), news, AI news enrichment. Schedule daily.", "default": false }, "admin_decision_sync": { "title": "🧠 Decision Engine Sync", "type": "boolean", "description": "Regenerates AI fight predictions for ALL upcoming events using latest news and stats. Schedule daily, 30 min after Daily Sync.", "default": false }, "target_org": { "title": "đŸŽ¯ Target Organization", "enum": [ "UFC" ], "type": "string", "description": "Select Organization", "default": "UFC" } } }, "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 } } } } } } } } } } ```