Data productv1 public, read-only
LLMReference API
v1 is a read-only public JSON API and MCP server for the same model, provider, pricing, and benchmark catalog that powers this site. There is no authentication and there are no accounts.
Catalog counts
2,320
Public models
177
Providers
3,103
Routes
203
Benchmarks
Endpoints
| Method | Path | Returns |
|---|---|---|
| GET | /api/v1 | API index |
| GET | /api/v1/models | List models (filters, sort, pagination) |
| GET | /api/v1/models/{slug} | One model: specs, capabilities, context, freshness, lifecycle |
| GET | /api/v1/models/{slug}/routes | Provider routes and pricing for one model |
| GET | /api/v1/models/{slug}/scores | Benchmark scores for one model |
| GET | /api/v1/providers | List providers |
| GET | /api/v1/providers/{slug} | One provider |
| GET | /api/v1/providers/{slug}/routes | Routes and pricing for one provider |
| GET | /api/v1/benchmarks | List benchmarks |
| GET | /api/v1/benchmarks/{slug} | One benchmark |
| GET | /api/v1/benchmarks/{slug}/scores | Scores for one benchmark |
| POST | /mcp | Streamable HTTP MCP (JSON-RPC) |
GET /api/v1/models parameters
| Param | Notes |
|---|---|
| provider | Provider slug (exact). Restricts models that have a route on that provider. |
| modality | text, image, video, audio, or multimodal. |
| open-weights | true or false. Alias: openWeights. True includes open-source and open-weights models. |
| openness | open-source, open-weights, proprietary, or unknown. |
| family | Family slug (exact). |
| category | Matches specialization or a use-case tag. |
| specialization | Exact specialization string. |
| deprecated | true or false. |
| sort | slug (default), name, release, or lastResearched. |
| order | asc (default) or desc. |
| limit | Page size. Default 50, max 200. |
| offset | Number of matches to skip. Default 0. |
- Success bodies are
{ "data": ..., "meta": { "version": "v1", "generatedAt", "dataSha", "count", "total?", "limit?", "offset?" } }. - Unknown slugs return 404 JSON. Invalid query parameters return 400 JSON.
- Score rows include
selfReportedandevidence(self-reportedorconfirmed). - Route objects include
pricingAvailability(for examplelistedorunpublished). - CORS is
*, including OPTIONS preflight. Cache-Control ispublic, max-age=0, must-revalidate(catalog changes on deploy).x-llmref-data-shais also set. - Rate limit is a best-effort per-IP cap of 60 requests / 60 seconds on /api/v1 and /mcp.
curl examples
List models
curl -sS 'https://www.llmreference.com/api/v1/models?provider=openai-api&modality=text&limit=5'One model
curl -sS 'https://www.llmreference.com/api/v1/models/gpt-5'Model routes
curl -sS 'https://www.llmreference.com/api/v1/models/gpt-5/routes'Model scores
curl -sS 'https://www.llmreference.com/api/v1/models/gpt-5/scores'Providers
curl -sS 'https://www.llmreference.com/api/v1/providers?limit=10'Provider routes
curl -sS 'https://www.llmreference.com/api/v1/providers/openai-api/routes'Benchmarks
curl -sS 'https://www.llmreference.com/api/v1/benchmarks?limit=10'MCP initialize
curl -sS -X POST 'https://www.llmreference.com/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.0.1"}}}'MCP client config
POST JSON-RPC to /mcp (Streamable HTTP). Tools: search_models, get_model, list_provider_routes, get_scores.
{
"mcpServers": {
"llmreference": {
"url": "https://www.llmreference.com/mcp"
}
}
}Last refreshed 2026-11-14. Next refresh: weekly.
Freshness on this page is the latest last-researched date in the seed catalog that backs GET /api/v1.