A diver exploring a wreck on the sea floor
COMING SOON

Spearo Catch API

Build on Spearo. A planned REST API with webhooks for catch data, species, leaderboards and more.

Catch Data

CRUD operations on catches with filtering, pagination, and search.

Species DB

400+ species with photos, common names, scientific names, and records.

Webhooks

Real-time notifications for catches, verifications, and leaderboard changes.

Auth

API key + OAuth 2.0 authentication. Scoped permissions.

A Preview of the API

Planned shape. Endpoints and fields may change before launch.

GET /api/v1/catches
curl -X GET "https://api.spearo.pro/v1/catches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "catch_abc123",
      "species": "Hogfish",
      "weight_lbs": 12.4,
      "depth_ft": 42,
      "verification_tier": "gold",
      "created_at": "2026-03-05T10:30:00Z"
    }
  ],
  "total": 312,
  "page": 1
}

Get Early Access

The Catch API is currently in development. Sign up to get early access and documentation.