Percy · Rate Limits

Percy Rate Limits

Percy does not publish fixed numeric per-endpoint request-rate limits for its REST API. The practical usage limit on Percy is the monthly screenshot allowance of your plan (5,000/month on the Free plan, more on paid plans, with overage billing beyond the included units) rather than a per-minute API request cap. The List Builds endpoint returns builds from the last 30 days, and list endpoints for builds and snapshots are cursor-paginated with a maximum page size of 30 items - an effective bound on how much can be read per request.

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

It captures 5 rate-limit definitions, measuring requests, screenshots, builds, snapshots, and days.

The profile also includes 2 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Visual Testing, Visual Regression, Screenshots, QA, and Rate Limiting.

5 Limits Throttle: 429
Visual TestingVisual RegressionScreenshotsQARate LimitingQuotas

Limits

REST API Request Rate account
requests
not published
No fixed numeric request-rate limit is documented for the Percy REST API.
Monthly Screenshot Allowance account
screenshots
per plan (5,000/month on Free)
The primary usage limit; overage beyond the included units is billed at the plan's overage rate.
Builds List Page Size request
builds
30
List Builds returns up to 30 builds per page via page[limit]; use page[cursor] to paginate.
Snapshots List Page Size request
snapshots
30
List Snapshots returns up to 30 snapshots per page (default and max); use page[cursor] to paginate.
Builds Lookback Window account
days
30
The List Builds endpoint returns builds from the last 30 days.

Policies

Cursor Pagination
Builds and snapshots list endpoints use page[limit] plus a page[cursor] (a resource ID) to page through results.
Backoff Strategy
Clients should implement exponential backoff with jitter and honor Retry-After on any 429 response.

Sources