Percy

Percy is an all-in-one visual testing and review platform, now part of BrowserStack. Test frameworks and CI upload DOM snapshots via the Percy CLI/SDK; Percy renders them across browsers and widths, diffs each against an approved baseline, and surfaces pixel-level visual changes for review and approval. On top of that workflow Percy exposes a documented REST API under https://percy.io/api/v1 for reading and managing Projects, Builds, and Snapshots, plus Visual Git (branchline) sync and merge operations. The snapshot capture/upload path itself is driven by the open-source Percy CLI and SDKs rather than a public REST upload endpoint.

Percy publishes 4 APIs on the APIs.io network, including Builds API, Projects API, Snapshots API, and 1 more. Tagged areas include Visual Testing, Visual Regression, Screenshots, QA, and Testing.

Percy’s developer surface includes authentication, documentation, engineering blog, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub
42.5/100 thin ▬ flat Agent 48/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessFreemiumSelf serve⚡ Free to try
4 APIs
Visual TestingVisual RegressionScreenshotsQATestingCI/CDBrowserStack

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 42.5/100 · thin
Contract Quality 15.5 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 48/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/percy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

Percy Builds API

A build logically groups the test sessions and snapshots of a run.

Percy Projects API

A project logically groups builds on Percy.

Percy Snapshots API

Snapshots are the individual visual comparisons within a build.

Percy Visual Git API

Branchline sync and merge of approved snapshots across branch lines.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Percy REST API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Percy Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Percy Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Percy Finops

FINOPS

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Percy Authentication

apiKey/http · 2 schemes

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Percy Agentic Access

13 operations · 7 acting

13 operations · 7 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 1

Authentication, authorization, and security posture

Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 3

The organization behind the API

LinkedIn
LinkedIn
 Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: percy
url: https://raw.githubusercontent.com/api-evangelist/percy/refs/heads/main/apis.yml
name: Percy
kind: company
description: Percy is an all-in-one visual testing and review platform, now part of BrowserStack. Test frameworks and CI upload
  DOM snapshots via the Percy CLI/SDK; Percy renders them across browsers and widths, diffs each against an approved baseline,
  and surfaces pixel-level visual changes for review and approval. On top of that workflow Percy exposes a documented REST
  API under https://percy.io/api/v1 for reading and managing Projects, Builds, and Snapshots, plus Visual Git (branchline)
  sync and merge operations. The snapshot capture/upload path itself is driven by the open-source Percy CLI and SDKs rather
  than a public REST upload endpoint.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/percy.png
tags:
- Visual Testing
- Visual Regression
- Screenshots
- QA
- Testing
- CI/CD
- BrowserStack
created: '2026-07-11'
modified: '2026-07-11'
specificationVersion: '0.19'
apis:
- aid: percy:percy-builds-api
  name: Percy Builds API
  description: A build logically groups the test sessions and snapshots of a run.
  humanURL: https://www.browserstack.com/docs/percy/api-reference/builds
  baseURL: https://percy.io/api/v1
  tags:
  - Builds
  properties:
  - type: OpenAPI
    url: openapi/percy-builds-api-openapi.yml
  - type: Documentation
    url: https://www.browserstack.com/docs/percy/api-reference/percy-apis
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/builds
  - type: PostmanCollection
    url: collections/percy.postman_collection.json
  - type: OpenCollection
    url: collections/percy.opencollection.json
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/snapshots
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/projects
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/visual-git
- aid: percy:percy-projects-api
  name: Percy Projects API
  description: A project logically groups builds on Percy.
  humanURL: https://www.browserstack.com/docs/percy/api-reference/builds
  baseURL: https://percy.io/api/v1
  tags:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/percy-projects-api-openapi.yml
  - type: Documentation
    url: https://www.browserstack.com/docs/percy/api-reference/percy-apis
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/builds
  - type: PostmanCollection
    url: collections/percy.postman_collection.json
  - type: OpenCollection
    url: collections/percy.opencollection.json
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/snapshots
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/projects
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/visual-git
- aid: percy:percy-snapshots-api
  name: Percy Snapshots API
  description: Snapshots are the individual visual comparisons within a build.
  humanURL: https://www.browserstack.com/docs/percy/api-reference/builds
  baseURL: https://percy.io/api/v1
  tags:
  - Snapshots
  properties:
  - type: OpenAPI
    url: openapi/percy-snapshots-api-openapi.yml
  - type: Documentation
    url: https://www.browserstack.com/docs/percy/api-reference/percy-apis
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/builds
  - type: PostmanCollection
    url: collections/percy.postman_collection.json
  - type: OpenCollection
    url: collections/percy.opencollection.json
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/snapshots
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/projects
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/visual-git
- aid: percy:percy-visual-git-api
  name: Percy Visual Git API
  description: Branchline sync and merge of approved snapshots across branch lines.
  humanURL: https://www.browserstack.com/docs/percy/api-reference/builds
  baseURL: https://percy.io/api/v1
  tags:
  - Visual Git
  properties:
  - type: OpenAPI
    url: openapi/percy-visual-git-api-openapi.yml
  - type: Documentation
    url: https://www.browserstack.com/docs/percy/api-reference/percy-apis
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/builds
  - type: PostmanCollection
    url: collections/percy.postman_collection.json
  - type: OpenCollection
    url: collections/percy.opencollection.json
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/snapshots
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/projects
  - type: APIReference
    url: https://www.browserstack.com/docs/percy/api-reference/visual-git
common:
- type: AgenticAccess
  url: agentic-access/percy-agentic-access.yml
- type: Authentication
  url: authentication/percy-authentication.yml
- type: GitHubOrganization
  url: https://github.com/percy
- type: LinkedIn
  url: https://www.linkedin.com/company/browserstack
- type: Website
  url: https://percy.io
- type: Documentation
  url: https://www.browserstack.com/docs/percy
- type: Plans
  url: plans/percy-plans-pricing.yml
- type: RateLimits
  url: rate-limits/percy-rate-limits.yml
- type: FinOps
  url: finops/percy-finops.yml
- url: https://percy.io/blog
  type: Blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com