Developers
Rate limits & fair use
YATools is free, so quotas keep it fast for everyone. Here are the exact numbers and what happens when you hit them.
Daily quotas
Limits apply per tool, per IP, per day (resets at midnight UTC). The six client-side tools — QR Code Generator, Word Counter, JSON Formatter, Password Generator, Case Converter, Color Picker — run entirely in your browser and have no limits at all.
| Tool | Route | Limit (per IP / day) |
|---|---|---|
| Website Screenshot | /api/v1/websnap | 20 / day |
| Audio to Text | /api/v1/transcribe | 10 / day |
| Text to Speech | /api/v1/tts | 30 / day |
| Wikipedia to PDF | /api/v1/wikipdf | 20 / day |
| n8n Workflow Search | /api/v1/n8n | 100 / day |
| AI Image Generator | /api/v1/tti | 10 / day |
| Movie & TV Search | /api/v1/msearch | 50 / day |
| Certificate Maker | /api/v1/certificate | 10 / day |
| AI Vision Chat | /api/v1/imgchat | 10 / day |
| Universal Downloader | /api/v1/alldl | 10 / day |
| Temporary Email | /api/v1/mail | 20 / day |
| Client-side tools | — | Unlimited |
What happens on 429
Exceed a quota and the API returns 429 Too Many Requests with the normalized error shape:
// HTTP 429 — also carries a Retry-After header (seconds)
{
"ok": false,
"provider": "yatools",
"fallbackUsed": false,
"error": {
"code": "RATE_LIMITED",
"message": "Daily limit reached for this tool — try again tomorrow."
},
"tool": "websnap"
}The response includes a Retry-After header with the number of seconds until the quota resets. The correct behavior is simple: back off, show the user a friendly message, and retry after the reset — don't hammer the endpoint.
Fair-use policy
- Personal projects, side projects, and small apps are exactly what the API is for.
- No automated scraping. Don't crawl the API in loops, don't parallelize requests to dodge quotas, and don't resell API access as your own service.
- Cache aggressively. Screenshots, PDFs, and generated images don't change — store them instead of re-requesting.
- Abuse gets blocked. IPs that ignore 429s or show bot-like patterns may be rate-limited harder or blocked entirely, without warning.
Need more than the quotas allow for a legitimate project? Talk to us before building workarounds — we'd rather find an arrangement than play whack-a-mole.
See also: the error reference and the API quickstart.