API Reference
Rate Limits
API usage is limited by monthly call count and vision call count, both scoped to the API key's tier. Limits reset on the first day of each calendar month.
Limits by tier
Tier Price Calls/mo Vision Overage Starter Free 25 10 — Builder $39 1,000 Included $0.04/call Scale $99 5,000 Included $0.02/call Pro $249 25,000 Included $0.01/call
What counts as a call
Every request to a protected endpoint consumes one call from the monthly limit. Cached vision calls (items previously identified via the image cache) consume a call but do not consume a vision call — the identification is served from cache without invoking the Vision API.
Rate limit response
Requests that exceed the monthly limit return a 429 status with upgrade information:
HTTP 429
{
"detail": "Monthly limit reached. Current tier: Starter (25 calls). Upgrade to Builder for 1,000 calls/month."
} Overage
Builder, Scale, and Pro tiers support overage at the per-call rates listed above. Starter tier does not support overage — requests above the limit are rejected until the next reset.