# 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:** 140 total users, 36 monthly users, 100.0% runs succeeded, 4 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,visita/fighting-intelligence-engine"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dv70EDRBoUqjgme7p/builds/tIKlNSfHL2KH4FxHh/openapi.json