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

39.1/100 thin ▬ flat Agent 29/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessFreemiumSelf serve⚡ Free to try

4 APIs

Visual Testing Visual Regression Screenshots QA Testing CI/CDBrowserStack

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 39.1/100 · thin

Contract Quality 14.6 / 25

Developer Ergonomics 4.8 / 20

Access Clarity 7.9 / 20

Operational Transparency 4.4 / 13

Contract Governance 0.0 / 12

Discoverability 7.4 / 10

Agent readiness — 29/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

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

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

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.

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.

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

Website

Website

Blog

Blog

Source (apis.yml)

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.23'
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:
  - Project
  tags_raw:
  - 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

Percy

Kin Score

APIs 4

Percy Builds API

Percy Projects API

Percy Snapshots API

Percy Visual Git API

Open Collections 6

API Collection

Percy REST Builds API

Percy REST Builds Projects API

Percy REST Builds Snapshots API

Percy REST Builds Visual Git API

Percy REST API

Pricing Plans 1

Percy Plans Pricing

Rate Limits 1

Percy Rate Limits

FinOps 1

Percy Finops

Security Posture 1

Percy Authentication

Agentic Access 1

Percy Agentic Access

Resources