Public JSON API
All endpoints accept GET requests and return JSON with permissive CORS headers. List endpoints paginate with limit and offset; the limit is clamped to 1–500 and defaults to 100.
| Endpoint | Response | Query parameters | Sort values |
|---|---|---|---|
/api/v1/ | API metadata and endpoint directory | — | — |
/api/v1/models | List text-generation model offerings | org, provider, min_context, min_output, min_intelligence, quantization, cache_read, cache_write, promo, zdr, sub, benchmarked, search, sort, order, limit, offset | id, input, output, cache_read, cache_write, context, max_output, uptime, discount, intelligence, coding, agentic |
/api/v1/models/:canonicalId/providers | List providers for one canonical model, ordered by cost | tokens, mix | — |
/api/v1/stats | Return catalog, provider, organization, privacy, cache, and quantization counts | — | — |
/api/v1/orgs | List model organizations with offering counts | — | — |
/api/v1/providers | List provider metadata and policy fields | zdr | — |
/api/v1/images | List image-generation models | org, provider, search, sort, order, limit, offset | id, org, provider |
/api/v1/images/:id | Return one image model with its pricing variants | — | — |
/api/v1/videos | List video-generation models | org, provider, search, sort, order, limit, offset | id, org, provider |
/api/v1/videos/:id | Return one video model with its pricing variants | — | — |
Examples
curl 'https://tokenwatch.wyrdwerk.com/api/v1/models?provider=aster&sort=input&limit=20'
curl 'https://tokenwatch.wyrdwerk.com/api/v1/models/glm-5.2/providers?tokens=1000000&mix=30,50,20'
curl 'https://tokenwatch.wyrdwerk.com/api/v1/providers?zdr=true'
curl 'https://tokenwatch.wyrdwerk.com/api/v1/videos?provider=fal&limit=25'Errors and freshness
Malformed model-ID encoding returns HTTP 400, unknown routes return 404, and unavailable catalog assets return 503. Every catalog response includes its source generation timestamp. Raw API and JSON files are marked noindex; this page is the crawlable reference.
Embeddable pricing cards
The widget demo shows the Shadow DOM pricing card. Add data-tw-model to an element and load https://tokenwatch.wyrdwerk.com/widget/embed.js.