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:

{
  "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:

# 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 or reach out via Apify.