BrandLovers Marketplace API V1

Name: BrandLovers Marketplace API V1 API
Brand: BrandLovers Marketplace API V1
Availability: InStock

✓ Official Vendor SpecE CommerceOrder ManagementapiKey36 EndpointsREST

For Agents

Manage products, orders, shipments, and customer tickets for a BrandLovers marketplace seller account through 36 JSON endpoints behind a single authorization-header token.

Quickstart

Get started with BrandLovers Marketplace API V1 in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"publish a product to a marketplace"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with BrandLovers Marketplace API V1 API.

Publish a new product to the marketplace via POST /product and update it later with PUT /product/{skuSellerId}

Push bulk price and stock changes through PUT /products/prices and PUT /products/stocks

List orders by status using GET /orders/status/new, /approved, /sent, /delivered, /canceled, and partial-state variants

Mark a shipment as sent, delivered, returned, or exchanged via POST /order/{orderId}/shipment/{action}

GET STARTED

Start building with BrandLovers Marketplace API V1 API

Explore with Jentic

View OpenAPI Document

The BrandLovers Marketplace API gives sellers a programmatic surface for the BrandLovers e-commerce marketplace, covering product onboarding, order lifecycle updates, shipment status, and customer support tickets across 36 endpoints. Sellers can publish or update SKUs, push price and stock changes in bulk, mark orders as sent or delivered, register exchanges and returns, and exchange messages on customer tickets. All requests are JSON over HTTPS authenticated with a per-seller authorization token issued from the BrandLovers admin console. The API is shaped for marketplace integrators that want to keep their internal commerce systems in sync with the BrandLovers storefront.

Use Cases

Patterns agents use BrandLovers Marketplace API V1 API for, with concrete tasks.

★ Seller onboarding and catalogue sync

Seed BrandLovers with the seller's full SKU catalogue and keep prices and stock in step with the upstream ERP or PIM. The integration calls POST /product per item on first sync, then uses PUT /products/prices and PUT /products/stocks for bulk updates whenever cost, MSRP, or warehouse counts change. This avoids manual catalogue uploads and prevents oversells.

POST /product for each SKU in the source feed, then on cadence call PUT /products/prices with the changed price array and PUT /products/stocks with the changed stock array.

Order fulfilment automation

Pull new orders into the warehouse system and push status back as they progress. Poll GET /orders/status/new for orders to pick, then call POST /order/{orderId}/shipment/sent with carrier and tracking once the parcel leaves, and POST /order/{orderId}/shipment/delivered when the carrier confirms drop-off. This keeps the buyer-facing order status accurate without double data entry.

GET /orders/status/new, for each order call POST /order/{orderId}/shipment/sent with the carrier tracking code, then on delivery confirmation call POST /order/{orderId}/shipment/delivered.

Returns and exchange handling

When a buyer returns an item, the seller registers it through POST /order/{orderId}/shipment/return so refunds and inventory restocks can be triggered downstream. Exchanges follow the same pattern with POST /order/{orderId}/shipment/exchange. Pairing this with PUT /product/{skuSellerId}/stock keeps stock counts honest after the returned unit is graded.

On return receipt, call POST /order/{orderId}/shipment/return with the reason code, then PUT /product/{skuSellerId}/stock to add 1 unit back to availability.

Customer support ticket triage

Open tickets on behalf of buyers when an issue is detected (for example a delayed shipment) and have a support agent reply through the same API. POST /ticket creates the ticket against an order, POST /ticket/{ticketId}/message appends replies, and PUT /ticket/{ticketId}/status closes it once resolved. GET /tickets and GET /ticket/{ticketId}/messages drive the support agent's worklist.

POST /ticket with orderId and an opening message, then on each agent reply call POST /ticket/{ticketId}/message and finally PUT /ticket/{ticketId}/status to close.

AI agent integration via Jentic

An agent that runs marketplace operations for a seller can discover BrandLovers through Jentic, load the relevant product or order operation, and execute it without holding the per-seller authorization token in its prompt. Jentic injects the token only at execution time and returns typed responses the agent can act on.

Through Jentic, search 'mark a marketplace order as shipped', load the operation that targets POST /order/{orderId}/shipment/sent, and execute with orderId and tracking code provided by the warehouse system.

Key Endpoints

36 endpoints — the brandlovers marketplace api gives sellers a programmatic surface for the brandlovers e-commerce marketplace, covering product onboarding, order lifecycle updates, shipment status, and customer support tickets across 36 endpoints.

METHOD

PATH

DESCRIPTION

POST

/product

Publish a new product (SKU) to the marketplace

PUT

/products/prices

Bulk-update prices across many SKUs

PUT

/products/stocks

Bulk-update stock counts across many SKUs

GET

/orders/status/new

List new orders waiting to be processed

POST

/order/{orderId}/shipment/sent

Mark an order as shipped with tracking

POST

/order/{orderId}/shipment/delivered

Mark an order as delivered

POST

/ticket

Open a support ticket against an order

POST

/ticket/{ticketId}/message

Append a message to an existing ticket

POST

/product

Publish a new product (SKU) to the marketplace

PUT

/products/prices

Bulk-update prices across many SKUs

PUT

/products/stocks

Bulk-update stock counts across many SKUs

GET

/orders/status/new

List new orders waiting to be processed

POST

/order/{orderId}/shipment/sent

Mark an order as shipped with tracking

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

BrandLovers seller authorization tokens are stored encrypted in the Jentic vault and attached to the authorization header at execution time. Agents call product, order, and ticket operations by intent, never holding the raw seller token in prompt context.

Intent-based discovery

Agents search Jentic for intents like 'mark a marketplace order as shipped' or 'publish a product to a marketplace' and Jentic returns the matching BrandLovers operation (POST /order/{orderId}/shipment/sent, POST /product) with input schemas typed.

Time to first call

Direct BrandLovers integration: 2-4 days to wire 36 endpoints across products, orders, shipments, and tickets, with token storage and status polling. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Braintree GraphQL API

Process the underlying card and wallet payments for orders captured in BrandLovers

Choose Braintree when the agent needs to charge or refund a payment; use BrandLovers to update the order's marketplace status.

Complementary

Brandfolder API

Pull approved product imagery from Brandfolder when publishing SKUs to BrandLovers

Use Brandfolder when the agent needs the canonical product photo; use BrandLovers to attach it to the marketplace listing.

Complementary

Braze API

Notify customers via Braze when a BrandLovers order ships or a return is confirmed

Use Braze when the agent needs to send an order update message; use BrandLovers to read or set the underlying order state.

FAQs

Specific to using BrandLovers Marketplace API V1 API through Jentic.

What authentication does the BrandLovers Marketplace API use?

The API uses an apiKey scheme: a per-seller authorization token passed in the authorization header on every request. The token is issued from the BrandLovers admin console. Through Jentic, that token is held in the encrypted vault and attached to each call at execution time.

Can I bulk-update prices and stock with the BrandLovers Marketplace API?

Yes. PUT /products/prices accepts an array of SKU price updates and PUT /products/stocks accepts an array of stock updates, so a single request can move many SKUs at once. Use these for nightly catalogue syncs rather than calling per-SKU endpoints in a loop.

How do I mark an order as shipped with the BrandLovers Marketplace API?

Call POST /order/{orderId}/shipment/sent with the carrier and tracking code in the body. When the carrier confirms delivery, follow up with POST /order/{orderId}/shipment/delivered. The order moves through the corresponding status that buyers see on the marketplace.

What are the rate limits for the BrandLovers Marketplace API?

The OpenAPI spec does not declare numeric rate limits. The marketplace asks integrators to use the bulk endpoints (PUT /products/prices, PUT /products/stocks) for catalogue-wide updates and to back off when 429 responses are returned during peak sync windows.

How do I publish a new product to BrandLovers through Jentic?

Install with pip install jentic, then await client.search('publish a product to a marketplace'), await client.load on the operation that targets POST /product, and await client.execute with the SKU payload. Jentic attaches the seller authorization token automatically.

Can I open and respond to customer tickets via the BrandLovers Marketplace API?

Yes. POST /ticket opens a ticket tied to an order, POST /ticket/{ticketId}/message appends a message, GET /ticket/{ticketId}/messages retrieves the thread, and PUT /ticket/{ticketId}/status closes or reopens the ticket. GET /tickets surfaces the full work queue.