TV dimensions API
Read-only public data requires no account or API key. Only published US models are available. Use the exact US model number and retain the catalogue version with your results.
- OpenAPI description and API catalogue
- Current catalogue version and snapshot URL
- Search models: GET /api/v1/models?query=sony&limit=10 (1–20 results)
- GET /api/v1/models/{modelNumber}: full published record, source references and canonical page. URL-encode the exact model number.
- Calculate screen geometry: diagonalInches is required; aspectWidth and aspectHeight default to 16 and 9. All inputs must be positive and no greater than 1000.
- Catalogue health: 503 if the compiled published catalogue is unavailable or empty.
Units, evidence and errors
Model dimensions use millimetres. Read original units, claim status, source precision and configuration before using a measurement. Unknown optional values remain unavailable. Screen calculations return inches and square inches, not cabinet measurements. Cabinet, assembled stand configurations, support footprint and carton remain separate. See methodology.
Responses are JSON. Invalid arguments return 400, missing models return 404, unavailable catalogue data returns 503, unsupported methods return 405, and rate-limited requests return 429 with Retry-After. Read endpoints allow cross-origin GET requests. There are no write operations in this API.
Versions and caching
The stable API points to the current compiled catalogue. Versioned /data/ snapshots are immutable while available, but older versions are not guaranteed to remain hosted after deployment. Stable pointers and API responses revalidate; save the returned catalogueVersion and source URLs when citing results.
Agent tools
Connect an MCP client to https://actualtvsize.com/api/mcp using Streamable HTTP. The server exposes search_tv_models, get_tv_model, calculate_screen_dimensions and compare_tv_dimensions. No authentication is required. Browser tools are registered when WebMCP is available.