NF Integrated Pitching Lab API

Developer Integration Guide

Version 1.0
August 2026

NewtForce LLC
Platforms for Responsive Data

Document Classification: Customer Documentation

Revision: 1.0

Prepared By: NewtForce LLC

Revision History

Table of Contents

1. Introduction
2. System Overview
3. Customer Environment
4. Authentication
5. Quick Start
6. Python Integration
7. API Fundamentals
8. Best Practices
9. Troubleshooting
10. Support

1 Introduction

Welcome

Welcome to the NF Integrated Pitching Lab API.

The NF Integrated Pitching Lab is a cloud-based biomechanics platform that provides secure access to athlete, session, pitch, video, and analytics data collected by the NewtForce Integrated Pitching Lab.

The API allows external applications to securely retrieve and update data while maintaining complete separation between customer organizations.

Whether you are writing a desktop application, a web application, an analytics package, or an artificial intelligence tool, the API provides a simple REST interface for accessing NewtForce data.

What Can the API Do?

• Authenticate organizations
• Retrieve pitchers
• Retrieve pitching sessions
• Retrieve pitch analytics
• Retrieve ground forct time series data
• Retrieve secure video URLs
• Download CSV files
• Upload files
• Upload AI documents
• Search pitching data using natural language
• Update existing pitch records

Intended Audience

• Software Developers
• Data Scientists
• Sports Scientists
• Baseball Organizations
• System Integrators
• Research Institutions

Prerequisites

Readers should understand HTTPS, REST APIs, JSON, and basic Python programming.

2 System Overview

                    Client Application

                         HTTPS

                           │

                           ▼

            NF Integrated Pitching Lab API

                           │

        ┌──────────────────┼──────────────────┐
        ▼                  ▼                  ▼

    Cloud SQL        Cloud Storage       Vertex AI

Each customer receives an isolated cloud environment.

Example:

https://<customer>.api.nfnotebooks.com

3 Authentication

Authenticate using:

POST /authenticate

Request:

{
    "organization": "Example Organization",
    "password": "ExamplePassword"
}

Response:

{
    "key": "xxxxxxxxxxxxxxxxxxxxxxxx",
    "bucket": "example-bucket"
}

Use the returned key on every protected request:

X-API-KEY: xxxxxxxxxxxxxxxxxxxx

4 Quick Start (Python)

import requests

BASE_URL = "https://<customer>.api.nfnotebooks.com"

response = requests.post(
    f"{BASE_URL}/authenticate",
    json={
        "organization": "Example Organization",
        "password": "ExamplePassword"
    }
)

response.raise_for_status()

API_KEY = response.json()["key"]

headers = {
    "X-API-KEY": API_KEY
}

pitchers = requests.get(
    f"{BASE_URL}/get-pitchers",
    headers=headers
).json()

print(pitchers)

Continue the workflow:

1. Authenticate
2. Get Pitchers
3. Get Sessions
4. Retrieve Pitch
5. Retrieve Time Series
6. Retrieve Video
7. Download CSV
8. Ask NewtForce AI

5 API Fundamentals

• GET – Retrieve information
• POST – Create or process data
• PATCH – Update existing data

Default content type:

Content-Type: application/json

6 Best Practices

• Authenticate once.
• Cache reference data.
• Always check HTTP status codes.
• Protect API keys.
• Use HTTPS.
• Retry transient failures appropriately.

7 HTTP Status Codes

8 Support

Interactive documentation:

https://<customer>.api.nfnotebooks.com/docs

Copyright © 2026 NewtForce LLC.