PB Vision API Partner Guide

Unlock automated pickleball video analysis and insights in your own product or platform.

The PB Vision API allows approved partners to send us game footage, then receive AI-generated performance data back once processing is complete. Our AI detects rallies, shots, errors, player movement, and player ratings, delivering pro-level analytics your users can explore in PB Vision or inside your own experience.

This guide covers the policies, pricing, billing models, and partner responsibilities involved in using the PB Vision API.

For legal terms of use, review the PB Vision API License Agreement:
https://pb.vision/api-license-agreement

For technical docs and data schemas, see:
https://github.com/pbv-public/partner-sdk-nodejs

Who the API is for

We designed the API for partners building technology around pickleball gameplay.

Common use cases:
• Camera hardware companies that want built-in automated analysis
• Facilities or academies that capture high volumes of play
• Tournament operators analyzing many matches
• App creators adding performance analytics to their apps
• Coaches who want fast analysis workflows directly from their own platform

If your business generates or manages pickleball video, the PB Vision API gives you transcoding, analysis, and analytics data delivery in one automated pipeline.

Requirements to Use the API

To ensure appropriate support and infrastructure costs are covered, API access requires:

  1. An active Annual Premium subscription

  2. An active API Add-on (PB Vision enables this after review)

Once enabled, all API uploads are billed according to API pricing rules below.

Resolution and Upload Rules

Standard API access supports:

  • Comply with PB Vision's framing guidelines

  • Resolution:

    • HD: 1920 × 1080 or lower

    • 4K only if explicitly enabled and billed accordingly

  • Supported formats: H.264, mp4

  • Frame rate: 30 or 60 FPS

Data Delivered

When processing completes, PB Vision provides:

  • A web page to explore stats and visual breakdowns

  • JSON callback containing shot-level insights, rally structure, stats, and player movement data

Data schemas:

We notify your system through a webhook callback once the analysis is done.

Privacy Controls for Partner Uploads

If you desire, partner uploads can be automatically set to Private by default. Private videos are:

  • Visible only to the uploader and registered editors

  • Hidden from public libraries

  • Manageable via userEmails metadata submitted with the upload

Just let us know!

Partner Billing Models

We support three flexible models, depending on your business:

1. Account Minutes (recommended)

• You pre-purchase video-processing minutes (if more needed then with plan)
• API usage deducts from that balance
• Most cost-effective
• Smooth experience with no invoices to manage

2. Monthly Invoice

• We invoice based on usage
• Requires high volume and payment method on file
• Best for use cases processing thousands of games

3. Passthrough Minutes

• You pass the cost of processing to the player’s PB Vision user account
• They need an active PB Vision subscription (unless it’s their first upload which is free)
• Limited use cases / applicability
• Often introduces friction and not typically recommended

Pricing

Every video processed by the API consumes video-processing minutes. These minutes cover cloud transcoding, AI compute time, and the automated data pipeline.

API-enabled accounts are not enabled to buy the standard consumer minute packs. Instead, API partners purchase minutes at API partner pricing (if/when more are needed from the Premium plan allowance).

  • HD (1080p or lower): $8 per hour of video processed
    (about $1.60 per 12-minute game)

  • 4K (must be explicitly enabled): $12 per hour
    (about $2.40 per 12-minute game)

API pricing isn’t directly equivalent to our per-minute subscription pricing. Here’s why API minutes cost more than subscription minutes:

  • For regular users, video transcoding happens on their phone (lower cost), while API uploads are transcoded in the cloud at our expense.

  • Some subscription users don’t use all of their minutes, allowing us to price slightly lower on average.

  • API partners receive additional benefits: API uploads and webhooks, priority support, whitelabeling options, and premium insight reports for non-subscribers.

Note: Invoice partners generally do not receive minute refunds for failed videos. They are responsible for ensuring footage meets our guidelines. If an issue is caused by a PB Vision error, we can make adjustments case by case.

Getting Started

To request access:
support@pb.vision

Please include:
• Your business/product use case
• Upload volume estimate per month
• Desired export data types (insights, stats, just the video, etc.)
• Preferred billing model

We will approve the account, enable the API, and provide onboarding support.

FAQ

Do you support registering multiple webhooks?

No, only one. That said, your server can forward the payload to other APIs/webhooks on your own servers of course.

Do you provide a way to verify the signature of incoming webhook requests?

No, not at this time.

Additional Resources

Partner API License Agreement:
https://pb.vision/api-license-agreement

SDK and technical reference:
https://github.com/pbv-public/partner-sdk-nodejs

Product demo gallery:
https://pb.vision/demo-gallery