API reference · Models

Estimate prompts

How many prompts a choice of models and frequency covers.

POST/api/v1/models/estimate

Nothing changes; use it to compare setups before updating. Models and frequency are workspace-wide, so the count covers every domain.

Body

modelsarrayRequired

Model keys, like chatgpt or claude-sonnet-4-5+web+high. See the catalog in GET /models.

frequencystringRequired

daily, 2d (every 2 days), 2w (twice a week) or weekly.

Returns

modelsarray

The models, as {key, label}.

frequencystring

daily, 2d, 2w or weekly; frequency_label has its name.

prompts_coveredinteger

Active prompts the plan covers with these models at this frequency, across all projects.

active_promptsinteger

Active prompts now, across all projects.

fitsboolean

Whether the active prompts fit.

Every response includes the project and the filters that were applied. Errors use the standard error object.

curl https://getonym.com/api/v1/models/estimate \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"models": ["chatgpt", "google-ai-overviews", "perplexity", "claude-sonnet-4-5+web"], "frequency": "daily"}'

import requests r = requests.post( "https://getonym.com/api/v1/models/estimate", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={"models": ["chatgpt", "google-ai-overviews", "perplexity", "claude-sonnet-4-5+web"], "frequency": "daily"}, ) print(r.json())

const r = await fetch("https://getonym.com/api/v1/models/estimate", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({"models": ["chatgpt", "google-ai-overviews", "perplexity", "claude-sonnet-4-5+web"], "frequency": "daily"}), }); console.log(await r.json());

{ "models": [ { "key": "chatgpt", "label": "ChatGPT" }, { "key": "google-ai-overviews", "label": "Google AI Overviews" } ], "frequency": "daily", "frequency_label": "Daily", "prompts_covered": 51, "active_prompts": 19, "fits": true }