# UFC Scraper API (x402)

> UFC Scraper API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Returns structured UFC fighter rankings, completed event fight cards, or fighter search results via pay-per-call web scraping.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-scraper-api-x402-96845c39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Wx7Om4hezTJBwbJr6SJE

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-scraper-api-x402-96845c39 -d '<json body>'
```

Example prompt: Can you pull the current top 10 UFC lightweight rankings for me, and also grab any completed events from 2024 — up to 50 records each?

## When to prefer this

Choose this endpoint when you need structured, up-to-date UFC fighter rankings, event fight cards, or fighter search results without maintaining your own scraper. It is ideal for sports analytics tools, chatbots answering UFC questions, or any agent that needs reliable MMA data on demand. The pay-per-call model with no charge for failed/empty runs makes it low-risk for exploratory queries.

## Known failure modes

- Invalid or missing mode enum returns a validation error
- searchQuery shorter than 2 characters is rejected
- season outside 1993–2100 range is rejected
- Empty results (no fighters or events found) are not charged
- Web scraping source unavailable or rate-limited may return empty or partial results
- maxItems exceeding 1000 is rejected

## How this service works

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

## Output

A JSON object with a count of records and an items array. Each item contains fighter name, division, nickname, athleteId, weightClass, recordType, sourceUrl, and scrapedAt timestamp. In byEvent mode, each event record includes its full fight card.

## 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-scraper-api-x402-96845c39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)