{"uid":"cap_gaGO9yGf6P6bh0qycHSEB","slug":"mlb-player-season-stats-bio-82fdfcc6","name":"MLB Player Season Stats & Bio","description":"MLB player season stats (hitting or pitching) and bio from the official MLB Stats API (statsapi.mlb.com). Input is the MLB person id; season stats only, no game feed. Free public data, MLB copyright applies.","url":"https://api.fadeandco.workers.dev/api/dev/mlb-stats?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"],"type":"string"},"queryParams":{"type":"object","required":["playerId"],"properties":{"group":{"type":"string","description":"hitting (default) or pitching"},"season":{"type":"string","description":"Season year YYYY (default: 2025)"},"playerId":{"type":"string","description":"MLB person id, e.g. 660271 (Shohei Ohtani)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"team":{"id":119,"name":"Los Angeles Dodgers"},"group":"hitting","stats":{"avg":".282","obp":".392","ops":"1.014","rbi":102,"slg":".622","hits":172,"runs":146,"atBats":611,"doubles":25,"homeRuns":55,"strikeOuts":187,"baseOnBalls":109,"gamesPlayed":158,"stolenBases":20},"player":{"id":660271,"name":"Shohei Ohtani","active":true,"number":"17","position":"Two-Way Player","birthDate":"1994-07-05"},"season":2025,"source":"https://statsapi.mlb.com/api/v1/people/660271/stats?stats=season&season=2025&group=hitting","checkedAt":"2026-10-23T09:35:24.455Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6QVH7lqaU1rVoX3heMKhD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns MLB player season hitting or pitching statistics plus biographical info from the official MLB Stats API for a given player ID and season year.","exampleAgentPrompt":"Can you pull up Shohei Ohtani's hitting stats for the 2025 season? His MLB player ID is 660271.","exampleUseCases":[{"title":"Fantasy baseball player evaluation","prompt":"I need to check Aaron Judge's season hitting stats for 2025 — home runs, RBI, batting average, OPS. His MLB player ID is 592450."},{"title":"Pitcher performance research","prompt":"Look up Gerrit Cole's pitching stats for the 2024 season using his MLB player ID 543037 — ERA, strikeouts, innings pitched, that kind of thing."},{"title":"Player bio and team lookup","prompt":"Can you tell me which team José Abreu plays for right now and pull his 2025 hitting stats? His MLB ID is 547989."}],"resultDescription":"A JSON object containing the player's biographical details (name, position, birth date, jersey number, active status), their team (name and ID), the requested stat group (hitting or pitching), a full stats object (e.g. avg, OBP, OPS, RBI, HR, SB for hitting), the season year, and the source URL from the official MLB Stats API, along with a timestamp of when the data was fetched.","failureModes":["Invalid or unknown MLB player ID returns empty or error response","Stat group not available for player (e.g. pitching stats for a position player) may return empty stats","Season year out of range or before player's career returns no stats","Missing required playerId parameter returns a validation error","Rate limiting or upstream MLB Stats API downtime causes failure"],"whenToPreferThis":"Choose this endpoint when you need official, structured MLB season statistics for a specific player by their MLB person ID. It is ideal for fantasy sports analysis, sports journalism, player comparison, or any agent workflow requiring authoritative MLB data. Prefer this over web scraping or unofficial sources because it proxies the official MLB Stats API and returns clean structured JSON. Best for per-player, per-season lookups rather than leaderboard or game-feed queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:22.328Z","isFirstParty":false,"canonicalSlug":"mlb-player-season-stats-bio-82fdfcc6"}