Developer API

The Business-tier API for programmatic listing generation.

Three endpoints cover the same quality bar as the workspace UI — generate a single listing, batch up to twenty-five at once, or fetch a previously generated draft by id.

Authentication

Every endpoint requires an Authorization: Bearer <api-key> header and a Business workspace. Generate keys from the workspace dashboard — keep them server-side and rotate quarterly.

POST
/v1/listings
Business API key
Generate one marketplace-shaped listing from product details — returns a title, description, tag pack, and SEO keywords for the selected target.

Request

{
  "name": "Cedar & Smoked Vanilla Candle · 9 oz",
  "category": "Soy candles",
  "features": [
    "Hand-poured in small batches",
    "45+ hour clean burn",
    "Phthalate-free, cotton wick",
    "Recyclable aluminum tin"
  ],
  "keywords": [
    "soy candle",
    "cedar",
    "vanilla",
    "housewarming",
    "sustainable"
  ],
  "target": "etsy",
  "voice": "artisanal"
}

Response

{
  "id": "ls_01HZX4KQ7M8N9P0R3T2V5W6Y7A",
  "status": "completed",
  "name": "Cedar & Smoked Vanilla Candle · 9 oz",
  "channels": {
    "etsy": {
      "title": "Hand-poured Soy Candle · Cedar & Smoked Vanilla · 9 oz Cotton Wick, Small Batch",
      "description": "A slow-burn soy candle that opens with cedar, settles into smoked vanilla, and finishes with a hint of warm amber. Hand-poured in our Brooklyn studio with phthalate-free fragrance and a cotton wick for an even, 45+ hour clean burn.",
      "tags": [
        "soy candle",
        "cedar candle",
        "vanilla candle",
        "housewarming gift",
        "cozy home"
      ],
      "keywords": [
        "soy candle",
        "cedar",
        "vanilla",
        "sustainable gift",
        "small batch"
      ]
    },
    "shopify": {
      "title": "Cedar & Smoked Vanilla Soy Candle · 9 oz · Hand-Poured · 45+ Hour Burn",
      "description": "A slow-burn candle that opens with cedar, settles into smoked vanilla, and finishes with a hint of warm amber. 9 oz of American-grown soy, phthalate-free fragrance, and a cotton wick that burns edge to edge without tunneling.",
      "tags": [
        "soy candle",
        "cedar",
        "vanilla",
        "sustainable",
        "small batch"
      ]
    }
  },
  "createdAt": "2026-08-13T14:21:08.347Z"
}

Channel metadata and keyword lines are optional — omitting them lets the server pick a sensible default per marketplace.

POST
/v1/bulk
Business API key
Submit up to 25 SKUs in a single request. Each item is processed independently and reported back as a queued job.

Request

{
  "items": [
    {
      "inputId": "row-1",
      "name": "Cedar & Smoked Vanilla Candle · 9 oz",
      "category": "Soy candles",
      "features": [
        "Hand-poured",
        "45+ hour burn",
        "Cotton wick"
      ],
      "keywords": [
        "soy candle",
        "cedar",
        "vanilla"
      ],
      "target": "etsy",
      "voice": "artisanal"
    },
    {
      "inputId": "row-2",
      "name": "8 oz Hand-Poured Travel Tin · Sea Salt & Driftwood",
      "category": "Soy candles",
      "features": [
        "Compact 8 oz tin",
        "Sea salt + driftwood",
        "30+ hour burn"
      ],
      "keywords": [
        "travel candle",
        "sea salt",
        "driftwood"
      ],
      "target": "shopify",
      "voice": "luxury"
    }
  ]
}

Response

{
  "jobs": [
    {
      "jobId": "job_01HZX4N2K9D5E6F7G8H3J4L5M6",
      "inputId": "row-1",
      "status": "queued",
      "estimatedSeconds": 18
    },
    {
      "jobId": "job_01HZX4N2K9D5E6F7G8H3J4L5M7",
      "inputId": "row-2",
      "status": "queued",
      "estimatedSeconds": 18
    }
  ]
}

Poll any job status with GET /v1/listings/:id — the returned `id` is interchangeable with `jobId`.

GET
/v1/listings/:id
Business API key
Fetch a previously generated listing by id — returns status, generated copy, channel variants, and a creation timestamp.

Request

{
  "method": "GET",
  "path": "/v1/listings/ls_01HZX4KQ7M8N9P0R3T2V5W6Y7A",
  "headers": {
    "Authorization": "Bearer lgai_live_4f9c…"
  }
}

Response

{
  "id": "ls_01HZX4KQ7M8N9P0R3T2V5W6Y7A",
  "status": "completed",
  "name": "Cedar & Smoked Vanilla Candle · 9 oz",
  "channels": {
    "etsy": {
      "title": "Hand-poured Soy Candle · Cedar & Smoked Vanilla · 9 oz Cotton Wick, Small Batch",
      "tags": [
        "soy candle",
        "cedar candle",
        "vanilla candle",
        "housewarming gift"
      ],
      "keywords": [
        "soy candle",
        "cedar",
        "vanilla",
        "sustainable gift"
      ]
    }
  },
  "createdAt": "2026-08-13T14:21:08.347Z"
}

`status` is one of `queued | processing | completed | failed`.

Need a higher-volume plan?

Custom rate limits, dedicated region, and SSO are negotiated alongside the Business tier — see /pricing for what Business unlocks, or email us with a one-paragraph note about your monthly volume and current stack.