BrewPage · Rate Limits

Brewpage Rate Limits

BrewPage relies primarily on hard structural caps (TTL, per-namespace counts, per-file size) and on User-Agent validation rather than on published numeric rate limits. The service reserves the right to throttle or reject anonymous or spoofed User-Agent requests and to flag abusive usage based on its 30-day access log.

Brewpage Rate Limits is the machine-readable rate-limit profile for BrewPage on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 11 rate-limit definitions, measuring request, result-set, day, byte, and file.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled, unauthorized, badRequest, notFound, payloadTooLarge, unsupportedMediaType, and conflict.

Tagged areas include Rate Limiting, Hosting, and Anti-Abuse.

11 Limits Throttle: 429
Rate LimitingHostingAnti-Abuse

Limits

User-Agent gating ip
request
rejected or rate-limited if User-Agent is missing or spoofed
User-Agent is REQUIRED on every request. Use a realistic identifiable UA in the form AgentName/version.
Owner-token scoped list visibility token
result-set
list endpoints return empty without a valid X-Owner-Token
Acts as a soft de-facto rate gate on enumeration.
Idempotent POST window token
request
byte-identical POST /api/html from same owner to `public/` within 24h returns existing id
Server header X-Existing-Resource - 1 signals replay; intended for retry safety.
TTL cap resource
day
30
Default 15, max 30. Older content is purged automatically.
File size cap resource
byte
5242880
5 MB per uploaded file; multipart larger than this returns HTTP 413.
Files per namespace namespace
file
1000
KV keys per store resource
key
1000
Returns HTTP 409 when exceeded.
JSON documents per collection namespace
document
10000
Site total size resource
byte
20971520
20 MB total per multi-file site.
Site file count resource
file
100
IndexNow quota account
request
documented as a finite quota; reuse PUT /api/html/{ns}/{id} for republish
Avoid burning IndexNow quota by preferring PUT over POST for updates.

Policies

User-Agent enforcement
Send `AgentName/version` (e.g. `Claude/4.5`). Missing or spoofed UAs may be flagged or rejected.
30-day access log retention
Every request (IP, UA, method, path, query, status, duration, timestamp) is logged for 30 days; visible to admin via GET /api/admin/access.
Update in place
Use PUT /api/html/{ns}/{id}, PUT /api/json/{ns}/{id}, PUT /api/kv/{ns}/{id}/{key} to replace content without changing the short URL — recommended over re-POST.
Conflict on namespace collision
Server returns 409 on `ns+id` collision; retry with a different id or omit id.
Blocked file types
Only safe file types are accepted (images, docs, archives, media, web assets). HTTP 415 for blocked types.

Sources