List listings | ListBee

import requests
url = "https://api.listbee.so/v1/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "id": "lst_7kQ2xY9mN3pR5tW1vB8a",
      "slug": "seo-playbook",
      "name": "SEO Playbook 2026",
      "highlights": [
        "50+ pages",
        "Actionable tips"
      ],
      "price": 500,
      "has_deliverables": true,
      "has_cover": true,
      "status": "published",
      "readiness": {
        "sellable": true,
        "actions": [
          {
            "code": "connect_stripe",
            "kind": "api",
            "priority": "required",
            "message": "Set Stripe secret key to accept payments",
            "resolve": {
              "method": "POST",
              "endpoint": "/v1/account/stripe-key",
              "url": "https://console.listbee.so/connect/stripe",
              "params": {
                "secret_key": "sk_live_..."
              }
            }
          }
        ],
        "next": "connect_stripe"
      },
      "created_at": "2026-04-01T12:00:00Z",
      "object": "listing",
      "description": "A comprehensive guide to modern SEO.",
      "tagline": "Updated for 2026 algorithm changes",
      "cta": "Get Instant Access",
      "deliverables": [
        {
          "id": "del_7kQ2xY9mN3pR5tW1vB8a01",
          "type": "file",
          "status": "ready",
          "object": "deliverable",
          "filename": "ebook.pdf",
          "size": 2458631,
          "mime_type": "application/pdf",
          "url": "https://example.com/secret",
          "content": "Buy signal: AAPL"
        }
      ],
      "fulfillment_url": "https://my-agent.com/fulfill",
      "checkout_schema": [
        {
          "key": "size",
          "type": "text",
          "label": "Shoe size",
          "required": true,
          "options": [
            "S",
            "M",
            "L"
          ],
          "sort_order": 0
        }
      ],
      "compare_at_price": 3900,
      "badges": [
        "Limited time"
      ],
      "cover_blur": "auto",
      "rating": 4.8,
      "rating_count": 1243,
      "reviews": [],
      "faqs": [],
      "metadata": {
        "source": "n8n"
      },
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "spring-sale",
      "url": "https://buy.listbee.so/seo-playbook",
      "embed_url": "https://buy.listbee.so/seo-playbook?embed=true"
    }
  ],
  "object": "list",
  "total_count": 47,
  "cursor": "lst_7kQ2xY9mN3pR5tW1vB8a",
  "has_more": false
}

List all listings for the authenticated account. Filter by status. Cursor-paginated. Each listing includes readiness — check readiness.sellable to see if it can accept orders.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Query parameters

statusenum or nullOptional

Filter by listing status.

Allowed values:

cursorstring or nullOptional

Pagination cursor from a previous response.

limitintegerOptional1-100Defaults to 20

Maximum number of listings to return.

Response

Successful Response

datalist of objects

Array of listing objects.

object"list"

Object type identifier. Always list.

total_countintegerDefaults to 0

Total number of matching resources across all pages

cursorstring or null

Pass as cursor query param to fetch the next page

has_morebooleanDefaults to false

True if more results exist beyond this page

Errors

401

Unauthorized Error

422

Unprocessable Entity Error