Getting Started

Introduction

ListBee is a REST API for creating and selling digital content. The primary resource is a listing — a product page with a title, price, and content payload. Create one, get back a URL. Buyers visit the URL, pay, receive the content.

Create a listing

Two required fields: name and price. Add deliverable and the listing can sell immediately. Currency is determined by your account settings.

$curl -X POST https://api.listbee.so/v1/listings \
>  -H "Authorization: Bearer lb_..." \
>  -H "Content-Type: application/json" \
>  -d '{
>    "name": "Python Async Patterns",
>    "price": 1900
>  }'
$# → { "object": "listing", "id": "lst_...", "slug": "python-async-patterns", "status": "draft" }

The url field is the product page. Share it with buyers directly. No additional setup required if Stripe is already connected.

What problems it solves

No API for agents to sell. Gumroad, Lemon Squeezy, and similar tools are console-only. An agent cannot create a listing programmatically without human intervention at every step.

No readiness feedback. Existing tools give no machine-readable signal about whether a listing is ready to sell. Agents have no way to know what action is needed next.

Console-only account setup. Connecting a payment method typically requires a human in a browser. ListBee’s account setup is fully API-driven — including Stripe key submission.

ListBee vs alternatives

ListBeeGumroadStripe Payment Links
Primary userAI agentsCreatorsDevelopers
Listing creationREST APIWeb consoleStripe dashboard
Content deliveryAutomatic via APIAutomaticManual
Readiness feedbackYes — machine-readableNoNo
Setup time~3 API calls~10 min in browser~5 min in dashboard

Commerce model

ListBee is agent-operated, human-facing commerce.

  • Agents call the API to create listings, update pricing, and manage content.
  • Humans visit product pages, pay via Stripe Checkout, and receive content by email.
  • Money flows from buyers through Stripe to the seller’s connected Stripe account. ListBee takes a fee per order.

Agents never touch payment data. Humans never interact with the API.

Pricing

PlanFeeMonthly
Free10% per order$0 (up to 50 orders)
Growth5% per order$29
Scale3% per order$79

Next steps

Quickstart

Three API calls to go from zero to a live listing.

Entity model

How accounts, listings, orders, and access grants relate.

Copy for AI assistants

$# ListBee API — key facts for AI agents
$#
$# Base URL: https://api.listbee.so
$# Auth:     Authorization: Bearer lb_...
$#
$# Core flow:
$#   1. POST /v1/auth/otp/start     { email }                  → OTP sent
$#   2. POST /v1/auth/otp/verify    { email, code }            → api_key
$#   3. POST /v1/account/stripe-key { secret_key }             → account.readiness.operational
$#   4. POST /v1/listings           { name, price }            → draft
$#      PUT  /v1/listings/{id}/deliverable  { type, value }    → managed
$#      POST /v1/listings/{id}/publish                         → published, sellable
$#
$# Listing response includes:
$#   - url:                product page URL (share with buyers)
$#   - readiness.sellable: true when buyers can purchase
$#   - readiness.actions:  list of actions needed if not sellable
$#   - readiness.next:     highest-priority action code
$#
$# ID prefixes: lst_ listing, ord_ order, acc_ account, lbk_ api-key entity, ag_ access grant
$# Errors: RFC 9457 Problem Details — { type, title, status, detail, code, param }
$# Docs:   https://docs.listbee.so
$# Spec:   https://api.listbee.so/openapi.json