Public REST API
API
Normalized current data with source-linked provenance.
Base URL
https://api.modelmarkets.ai/api/v1
The production origin is deployed and health-checked. Responses remain labeled as sample data until collectors are activated. Local development uses http://localhost:8000/api/v1.
Response Envelope
{
"data": { ... },
"meta": {
"dataset_status": "sample | live",
"is_live": false,
"disclaimer": "..."
}
}v1 Endpoints
Current Surface
| Method | Path | Returns |
|---|---|---|
| GET | /api/v1/models/ | Model version directory with provider offerings, route readiness, and price ranges. |
| GET | /api/v1/models/{organization}/{model}/ | Complete model record with route targets, prices, aliases, and provenance. |
| GET | /api/v1/apps/ | AI app and agent-product directory with deployment, access, and platform fields. |
| GET | /api/v1/apps/{organization}/{app}/ | Complete app record with automation, integrations, comparisons, and provenance. |
| GET | /api/v1/app-comparisons/ | Curated app pairs with shared capabilities and comparison eligibility. |
| GET | /api/v1/comparisons/ | Every evidence-eligible unordered model pair; model_a and model_b search the complete matrix, while limit and offset provide deterministic slices. |
| GET | /api/v1/providers/ | Inference provider directory with public routing contracts. |
| GET | /api/v1/providers/{provider}/ | Provider model routes, API protocol, pricing, and sources. |
| GET | /api/v1/provider-comparisons/{left}-vs-{right}/ | Shared models and sourced routing fields for a canonical provider pair. |
| GET | /api/v1/pricing/ | Current normalized price records with units and source classification. |
| GET | /api/v1/provenance/ | Source registry and collection metadata. |
| GET | /api/v1/compute/ | Compute venue and instrument metadata. |
| GET | /api/v1/health/ | API origin health. |
| GET | /api/v1/ready/ | API dependency readiness checks. |
| GET | /api/v1/api-keys/status/ | Validate an API key and return its prefix and rate limit. |
Free Authenticated Access
Get a free API key after confirming your email. Confirmation creates a passwordless account; send the key as X-API-Key or Authorization: Bearer …. All keys on an account share a 600 request-per-minute limit.
Missed the one-time copy? Open your account and select Create New API Key. Existing keys remain active.
Cache Contract
Responses include public cache-control with stale-while-revalidate, keeping repeated reads fast while preserving source freshness.