SuperPenguin Docs
Getting Started

Create an API key

Create a SuperPenguin API key and keep it server-side.

  1. Sign in to the dashboard.
  2. Open API Keys (also linked as API Keys).
  3. Click Create API Key.
  4. Copy the key immediately. It starts with sp_ or sp- and is shown once.

Use the key safely

Store the key in a server environment variable such as SP_API_KEY. Never expose it in client-side JavaScript, mobile apps, or public repositories.

Python:

import superpenguin as sp

sp.init(api_key="sp_...")  # or rely on SP_API_KEY

TypeScript:

import { init } from "@superpenguin/js";

init({ apiKey: process.env.SP_API_KEY });

If SP_API_KEY is set, both SDKs can initialize automatically on first use.

Optional overrides

VariablePurpose
SP_API_KEYSuperPenguin ingest key
SP_BASE_URLOverride the default API base URL (advanced / staging)

Next: Add attribution metadata.