Rate Limits#
Rate Limits#
Lookup Limits#
User Type |
Lookups/Day |
Included API calls/month |
Notes |
|---|---|---|---|
Anonymous |
20 |
– |
No account needed |
Free account |
60 |
– |
Sign up at my.turtletech.us |
Academic plan |
20,000 |
10,000 |
EUR 4/month |
Business plan |
20,000 |
40,000 |
EUR 10/month |
What Counts as a Lookup?#
Action |
Counts? |
|---|---|
DOI lookup (new paper) |
Yes |
ISBN lookup (new book) |
Yes |
Reverse lookup (paste text) |
Yes |
DOI/ISBN already in your collection |
No |
Manual entry |
No |
Re-format (change style) |
No |
Format endpoint |
No |
Group citation |
No |
Health check |
No |
Papers saved in your collections are free to re-lookup as long as they remain in the collection. Removing a paper means the next lookup will count against quota.
A paid plan spends purchased calls after its included calls are spent. Those
calls do not reset, and the daily cap still applies. With neither balance
left, the response is HTTP 402 and the call does not run. The daily cap
returns HTTP 429. A free plan can spend purchased calls after its daily cap,
and that call is not another free lookup. GET /api/v1/key reports the
included limit, the calls left, and wallet_calls when the ledger answers.
A resolve batch spends one call for each input, from the included month or from purchased calls. An async batch records those calls as the worker runs each input. Job status and result polls do not spend a call.
Batch and Collection Operations#
Batch formatting and verification use the normal lookup quota. Batch collection adds and BibTeX/RIS imports are available to signed-in Free accounts. Collection merge and batch move require an Academic or Business plan; those endpoints return HTTP 403 to a Free account:
{
"error": "plan_required",
"message": "This feature requires an Academic (EUR 4/mo) or Business (EUR 10/mo) plan.",
"upgrade_url": "https://my.turtletech.us"
}
Collection Entry Limits#
Plan |
Collections |
Entries per collection |
|---|---|---|
Free |
4 |
200 |
Academic |
10 |
1,000 |
Business |
20 |
4,000 |
Reset#
Daily limits reset 24 hours after your first lookup of the day. Monthly limits reset on the first of each month.
Structured quota policy#
GET /api/v1/quota-policy returns the limits for Anonymous and Free use,
the caller’s active plan, remaining lookups, reset interval, and symbolic
account actions. Actions are stable identifiers such as sign_in,
create_free_account, and view_plans; the response contains no redirect
URL.
Quota exhaustion returns HTTP 429 with the same active-plan fields, a stable
quota_exhausted error kind, a bounded human-readable message, and
retry_after. Retry-After, X-RateLimit-Limit,
X-RateLimit-Remaining, and X-RateLimit-Reset match the JSON body.
{
"error": "quota_exhausted",
"message": "Daily limit reached (20/day).",
"retry_after": 3600,
"anonymous_daily_limit": 20,
"free_daily_limit": 60,
"active_plan": "Anonymous",
"limit": 20,
"remaining": 0,
"reset_seconds": 3600,
"actions": ["sign_in", "create_free_account", "view_plans"]
}
Burst Limit#
Anonymous traffic is limited to 100 requests/minute per IP address. Authenticated traffic is limited to 600 requests/minute per credential.