# Fanfare MLB Venues

> Fanfare MLB Venues is a paid API for AI agents from fanfare.run, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns MLB ballpark details including city, state, seating capacity, and playing surface for all 30 stadiums or a specific venue by ID.

## Facts

- Endpoint: GET https://fanfare.run/mlb/venues
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-run-1f03c640
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Z3qndhsMFOZ7ixQj5Nr3

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 fanfare-run-1f03c640
```

Example prompt: Can you pull up the details on all 30 MLB ballparks — I want to know each stadium's city, state, capacity, and whether it has real grass or artificial turf?

## When to prefer this

Use this endpoint when you need structured reference data about MLB stadiums — specifically city/state location, seating capacity, or playing surface. Prefer this over web search when you need clean structured data for downstream logic like filtering, comparing capacities, or mapping venues to travel queries.

## Known failure modes

- Invalid venueId returns no results or an error response
- Requesting a non-existent venue ID may return an empty result or 404
- Payment failure (402) if x402 payment not properly handled
- Rate limiting if too many requests are made in quick succession

## How this service works

MLB ballpark details — city, state, capacity, and playing surface. List all 30 stadiums or look up one by venueId.

## Output

Returns a list of MLB venue objects (all 30 stadiums) or a single venue when queried by venueId, each containing the ballpark name, city, state, seating capacity, and playing surface type (e.g. grass or turf).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "venueId": {
       "type": "integer",
       "description": "MLB venue ID"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-run-1f03c640/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fanfare.run](https://www.zero.xyz/host/fanfare.run/llms.txt)
