Resources

FAQ

What is ListBee?

Listings infrastructure for AI agents. One API call to sell digital content. Create a listing, get back a URL. Buyers visit the URL, pay, receive the content.

How is it different from Gumroad?

Gumroad is for humans clicking buttons in a console. ListBee is for code. There is no ListBee dashboard you need to visit to create a listing — you call an API. Agents can create listings, check readiness, and guide users through Stripe setup without any browser interaction.

Is it free?

Yes. The free plan costs nothing and takes no credit card to start.

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

What can I sell?

Any digital content:

  • PDFs, ebooks, guides
  • ZIP files, datasets, software
  • Notion pages, Google Docs, gated URLs
  • License keys, API keys, access codes
  • Plain text payloads of any kind

ListBee detects the content type automatically. See Content Types for how detection works.

Do I need Stripe?

Yes. ListBee uses Stripe to process payments. You have two options:

  1. Submit your Stripe secret key via POST /v1/account/stripe-key — takes seconds if you already have a Stripe account.
  2. Stripe Connect onboarding via POST /v1/account/stripe/connect — returns a URL to complete setup in your browser. This is the path if you don’t have a Stripe account yet.

Money flows from buyers through Stripe directly to your account. ListBee deducts its platform fee before the payout.

Can I use it from ChatGPT or Claude?

Yes. Three ways:

  • MCP server — add the ListBee MCP server to your Claude or Cursor config and all API endpoints are available as tools. See the MCP docs.
  • Python SDK — pip install listbee, then use the typed client in any Python environment.
  • Direct API — standard REST calls with Authorization: Bearer lb_....

Where does the money go?

Directly to your Stripe account. ListBee deducts the platform fee (10%, 5%, or 3% depending on your plan) before the payout. You do not receive the gross amount and then pay ListBee separately — the fee is taken at the point of payment.

Can I update a listing after creating it?

Yes, but not the content. Use PUT /v1/listings/{slug} to update name, price, description, and cover image. The content field is immutable — delete the listing and recreate it to change the content payload.

What happens when someone buys?

  1. Buyer visits the product page (https://buy.listbee.so/{slug}).
  2. Buyer pays via Stripe Checkout.
  3. ListBee creates an order object.
  4. Buyer receives an email with the content (download link, redirect URL, or inline text).
  5. If you have webhooks configured, ListBee sends an order.completed event.

Can I refund a buyer?

Refunds are processed through Stripe directly. ListBee does not currently expose a refund API endpoint — go to your Stripe dashboard to issue a refund.

Is there a sandbox / test mode?

Use a sk_test_... Stripe key instead of sk_live_.... Stripe test mode lets you make test purchases without real money. All ListBee endpoints work the same way regardless of which Stripe key you use.

Next steps

Copy for AI assistants

Cursor / Claude Code
1# ListBee FAQ — key facts
2#
3# What: REST API for selling digital content. One call = listing + checkout URL.
4# Who: AI agents, automation tools, developers. Not a human-facing console product.
5# Pricing: Free (10%/order, 50 orders/mo), Growth ($29/mo, 5%), Scale ($79/mo, 3%)
6#
7# Requirements: Stripe account (submit sk_live_... or go through Connect onboarding)
8#
9# Content types: FILE (PDF/ZIP/etc → CDN + signed URL), URL (redirect), TEXT (inline)
10# Content is immutable after listing creation — delete and recreate to change
11#
12# Updates via PUT /v1/listings/{slug}: name, price, description, cover
13#
14# After purchase: buyer gets email with content. order.completed webhook fired.
15# Refunds: via Stripe dashboard — no ListBee refund API.
16# Test mode: use sk_test_... Stripe key — all endpoints behave identically.
17#
18# MCP server available — see https://docs.listbee.so/mcp
19# Python SDK: pip install listbee
20# Auth: Authorization: Bearer lb_...
21# Docs: https://docs.listbee.so