# UFC Fighter & Event Data Scraper

> UFC Fighter & Event Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured UFC data including ranked fighters by weight class, completed event fight cards, or fighter search results

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/ufc?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ufc-fighter-event-data-scraper-7d72a587
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O11R03DUzm5qz83oi5LQh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ufc-fighter-event-data-scraper-7d72a587 -d '<json body>'
```

Example prompt: Pull the current UFC lightweight rankings for me — top 50 fighters — so I can see who's ranked where in the division right now.

## When to prefer this

Choose this endpoint when you need structured UFC-specific data including fighter rankings, event fight cards, or fighter search — especially when you need it in clean JSON format without building your own scraper. Ideal for agents that need real-time or recent UFC roster and ranking data without maintaining a sports database. Prefer over generic web search when you need machine-readable fighter/event records with consistent schema fields like athleteId and division.

## Known failure modes

- Empty result set if searchQuery is fewer than 2 characters
- No results returned for years with no completed UFC events
- Invalid weightClass enum value causes request failure
- Season year outside 1993–2100 range is rejected
- Network or scraping failure returns an error (not charged)
- Empty or failed runs are not billed

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of records and an array of items. Each item includes fighter name, division, nickname, athleteId, weight class, record type, source URL, and scrape timestamp. For event mode, each record includes the full fight card for that event.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "topRanked",
    "byEvent",
    "searchFighters"
   ],
   "type": "string",
   "default": "topRanked",
   "description": "Choose ranked fighters, completed events, or fighter name search."
  },
  "season": {
   "type": "integer",
   "maximum": 2100,
   "minimum": 1993,
   "description": "Calendar year for completed events mode. Defaults to the current UTC year."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum fighter or event records to save. Each event record includes its full fight card."
  },
  "searchQuery": {
   "type": "string",
   "description": "At least two characters of a fighter name for search fighters mode."
  },
  "weightClass": {
   "enum": [
    "All",
    "Heavyweight",
    "Light Heavyweight",
    "Middleweight",
    "Welterweight",
    "Lightweight",
    "Featherweight",
    "Bantamweight",
    "Flyweight",
    "Women's Bantamweight",
    "Women's Strawweight",
    "Women's Flyweight",
    "Men's Pound-for-Pound",
    "Women's Pound-for-Pound"
   ],
   "type": "string",
   "default": "All",
   "description": "Ranking division to collect in ranked fighters mode. All includes every ranking, including pound-for-pound lists."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "division": null,
    "nickname": null,
    "athleteId": null,
    "scrapedAt": null,
    "sourceUrl": null,
    "recordType": null,
    "weightClass": null
   }
  ],
  "product": "ufc"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ufc-fighter-event-data-scraper-7d72a587/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)