Skip to main content

Marketplace API

The Marketplace API documented here is the character template marketplace, not the brand-deal application workflow. It lets sellers list reusable character concepts and lets buyers purchase and clone them into their own workspace.

Endpoints​

  • GET /api/v1/marketplace
  • GET /api/v1/marketplace/{id}
  • POST /api/v1/marketplace/{id}/purchase
  • POST /api/v1/marketplace/listings
  • PUT /api/v1/marketplace/listings/{id}
  • DELETE /api/v1/marketplace/listings/{id}
  • GET /api/v1/marketplace/my-listings
  • GET /api/v1/marketplace/my-purchases

Browse listings​

Supported filters include:

  • q
  • niche
  • min_price
  • max_price
  • rating
  • page
  • page_size
curl "https://api.influgen.ai/api/v1/marketplace?q=fitness&niche=wellness&min_price=100&max_price=500&page=1&page_size=10" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Create a listing​

curl https://api.influgen.ai/api/v1/marketplace/listings \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "character_id": "char_01HZX6FQJ5N6E7T2M3A4B5C6D7",
    "price": 250,
    "currency": "USD",
    "license_type": "commercial",
    "status": "active",
    "preview_images": [
      "https://cdn.example.com/listings/mila-preview-1.jpg"
    ],
    "description": "Premium fitness creator template with clean wellness positioning."
  }'

Example response:

{
  "listing": {
    "id": "mkt_01HZZ0J7N7P5B4K2V1Q9R8S6T5",
    "character_id": "char_01HZX6FQJ5N6E7T2M3A4B5C6D7",
    "price": 250,
    "currency": "USD",
    "license_type": "commercial",
    "status": "active"
  }
}

Validation includes:

  • character required
  • valid positive price
  • valid currency
  • valid license type
  • valid listing status

Purchase a listing​

curl -X POST https://api.influgen.ai/api/v1/marketplace/mkt_01HZZ0J7N7P5B4K2V1Q9R8S6T5/purchase \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Purchase can fail if:

  • you try to buy your own listing
  • the listing is no longer available
  • you already purchased it
  • you do not have enough credits
  • your workspace has reached its character limit

Seller and buyer dashboards​

Use:

  • GET /api/v1/marketplace/my-listings
  • GET /api/v1/marketplace/my-purchases

These routes are useful for building seller dashboards, purchase libraries, and internal tooling around template operations.

Public API note​

The character marketplace is not part of the Agency public API key surface today. Use session auth for marketplace actions.