{"uid":"cap_rrBOKz1Y7Zr6ACHMp8UKm","slug":"mlb-structured-data-api-x402-127aeb26","name":"MLB Structured Data API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/mlb?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"One schedule or game-details date in YYYY-MM-DD format."},"mode":{"enum":["teams","players","schedule","standings","playerStats","gameDetails","leaders"],"type":"string","default":"teams","description":"Choose teams, roster players, games, standings, player season statistics, team game totals, or ranked leaders."},"gamePk":{"type":"integer","description":"One game ID for game details, merged with Game IDs."},"season":{"type":"integer","description":"Optional single season year; merged with Seasons when both are set."},"teamId":{"type":"integer","description":"One club ID, merged with Team IDs when both are set."},"toDate":{"type":"string","description":"Last schedule or game-details date in YYYY-MM-DD format."},"gamePks":{"type":"array","description":"Game details for these game IDs; leave empty to discover games from dates or seasons."},"seasons":{"type":"array","description":"Season years to collect. Leave empty for the current year."},"teamIds":{"type":"array","description":"Optional club IDs to filter teams, rosters, games, standings, stats, or leaders."},"fromDate":{"type":"string","description":"First schedule or game-details date in YYYY-MM-DD format."},"gameType":{"enum":["R","S","P","W","L","A"],"type":"string","default":"R","description":"Game classification for schedule, game details, and leaderboards."},"leagueId":{"enum":["both","AL","NL"],"type":"string","default":"both","description":"League filter for standings."},"maxItems":{"type":"integer","default":1000,"minimum":1,"description":"Maximum dataset rows to return across all seasons and categories."},"playerId":{"type":"integer","description":"One player ID for player statistics, merged with Player IDs."},"playerIds":{"type":"array","description":"Player statistics for these player IDs; leave empty to use selected club rosters."},"statGroup":{"enum":["hitting","pitching","fielding"],"type":"string","default":"hitting","description":"Player stats or leaders for hitting, pitching, or fielding."},"leaderCategories":{"type":"array","description":"Statistic categories for ranked leaders, such as homeRuns, battingAverage, strikeouts, or saves."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"age":null,"avg":null,"active":null,"atBats":null,"airOuts":null,"assists":null,"abbreviation":null,"atBatsPerHomeRun":null}],"product":"mlb"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5mOJm2BXnjfSJyRZDBZhX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured MLB data including teams, players, schedules, standings, stats, game details, and leaderboards for specified seasons and date ranges.","exampleAgentPrompt":"Pull the current MLB standings for both leagues and also get the hitting leaders for home runs this regular season, limited to the top 50 players.","exampleUseCases":[{"title":"Daily fantasy sports lineup research","prompt":"Get me the hitting stats for players with team ID 147 (Yankees) and 111 (Red Sox) for the 2024 regular season, up to 200 rows, so I can compare their performance."},{"title":"Live game schedule lookup","prompt":"What MLB games are scheduled between 2025-07-01 and 2025-07-07 for regular season play? Show me all teams."},{"title":"Player season performance deep-dive","prompt":"Fetch the pitching stats for player IDs 592450 and 477132 for the 2023 and 2024 seasons so I can compare their ERA and strikeout trends."}],"resultDescription":"A JSON object with a count field and an items array containing rows of MLB data. Each row may include fields like age, batting average, at-bats, air outs, assists, abbreviation, and other stat columns depending on the requested mode. The product field is always 'mlb'.","failureModes":["Invalid date format returns an error or empty result","Unknown teamId or playerId returns zero items (not charged)","Unsupported mode or enum value rejected at input validation","Empty result sets for future dates or off-season periods (not charged)","Rate limiting or payment failure via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need structured, multi-modal MLB data (teams, rosters, schedules, standings, player stats, game details, or leaders) in a single pay-per-call API without managing a scraper. Especially useful when you need flexible filtering by team, player, season, date range, and game type. Prefer this over raw HTML scraping or building your own MLB Stats API integration. Best when failed/empty calls should not incur cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:12.382Z","isFirstParty":false,"canonicalSlug":"mlb-structured-data-api-x402-127aeb26"}