Skip to main content

Documentation Index

Fetch the complete documentation index at: https://podium.build/docs/llms.txt

Use this file to discover all available pages before exploring further.

Time to first call: ~60 seconds. Get your API key from the Developer Portal — sign in, and your key is generated automatically. Free plan, no credit card.

1. Get Your API Key

Head to app.podium.build/onboarding and sign in. Your API key is generated instantly.

2. Make Your First Call

Paste this into your terminal (replace the key):
curl https://api.podium.build/api/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
A successful response returns a JSON array of products scoped to your organization.

3. Try the SDK

npm install @podium-sdk/node-sdk
import { createPodiumClient } from '@podium-sdk/node-sdk'

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY!,
})

// List products
const products = await client.product.list({ page: 1, limit: 5 })
console.log(products)

// Or search across entities
const results = await client.search.search({
  query: 'vitamin c serum',
  limit: 5,
})
console.log(results)
The SDK auto-detects staging vs production from your key prefix (podium_test_ vs podium_live_). Ships with full TypeScript types from the OpenAPI spec.

4. Explore

API Playground

Try endpoints live — paste your key and send requests

Build a Shopping Agent

Full tutorial: memory, scoring, checkout, and settlement

Agent Tooling

Plug Podium into Claude, Cursor, LangChain, or any MCP runtime

Machine Payments

Autonomous USDC settlement on Base

API Key Details

Keys are prefixed by environment:
PrefixEnvironmentAPI Base URL
podium_test_Staginghttps://podium-staging.up.railway.app/api/v1
podium_live_Productionhttps://api.podium.build/api/v1
Your full API key is only shown once at creation time. Copy it immediately and store it securely. The dashboard only displays the key prefix after that.
Manage keys from the Dashboard — create, rotate, enable/disable, or delete.

Pricing

TierPriceRequests/MonthRate Limit
BuilderFree10,0005/sec
Growth$99/mo100,00020/sec
Pro$499/mo1,000,000100/sec
See full pricing →

Ready to build?

Build an Agent

Intelligent commerce agents with memory, scoring, and settlement

Commerce API

Products, orders, checkout, creators, payments, and more

Smart Contracts

On-chain Task Pool, solver reputation, and USDC settlement on Base