Skip to content

BrandLovers Marketplace API V1 API

by brandlovers.com

API keyHTTPSShopping
Open documentation ↗

Overview

Allows sellers to: 1) Load products definitions to the BrandLovers marktplace. 2) Receive and update orders status. 3) Receive and update shipping information. 4) Receive and update customer tickets. All requests consume and return application/json content. All request must be authenticated and use HTTPS.

BrandLovers Marketplace API V1 is a shopping API from brandlovers.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 36 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Shopping
Base URL
https://api.brandlovers.com/marketplace/v1
Version
1.0.0
Endpoints
36
Spec updated
2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.brandlovers.com/marketplace/v1/orders" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://api.brandlovers.com/marketplace/v1/orders", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.brandlovers.com/marketplace/v1/orders",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/order/{orderId}Returns all details of a order
POST/order/{orderId}/shipment/cancelConfirm shipment canceletion (when requested by the customer) or failure to deliver
POST/order/{orderId}/shipment/deliveredConfirms that a shipment was delivered
POST/order/{orderId}/shipment/exchangeConfirm item exchange
POST/order/{orderId}/shipment/returnConfirm order item return and refund
POST/order/{orderId}/shipment/sentUpdate new order to include shipment information
GET/ordersReturns orders details
GET/orders/shipments/deliveredReturns list of shipments
POST/orders/shipments/deliveredBulk update of order shipments
GET/orders/shipments/shippedReturns a list of shipments shipped
POST/orders/shipments/shippedBulk update of order shipments
GET/orders/status/approvedReturn list of approved orders
GET/orders/status/canceledReturns lists of canceled orders
GET/orders/status/deliveredReturns a list of orders successfully delivered associated with this seller.
GET/orders/status/newReturns a list of orders flagged as new.
GET/orders/status/partiallyDeliveredReturns a list of partially deliverd orders
GET/orders/status/partiallySentReturns a list of orders partially fullfiled
GET/orders/status/sentReturns a list with orders fully sent
POST/productCreate a new product to the marketplace
GET/product/{skuSellerId}Returns details of a single product using the seller `skuSellerId`
PUT/product/{skuSellerId}Update product details
PUT/product/{skuSellerId}/pricesAllows seller to update prices of a single SKU
PUT/product/{skuSellerId}/statusEnable/disable a single product in the Marketplace
PUT/product/{skuSellerId}/stockUpdate a single product stock
GET/productsReturns a list of products loaded into BrandLovers Marketplace
POST/productsAllows new products from the seller to be loaded into the marketplace
PUT/products/pricesAllows bulk update of product prices.
GET/products/statusReturns seller products status in the marketplace
PUT/products/statusBulk enable/disable products in the marketplace
GET/products/status/sellingReturns products that are successfully listed for sale.
PUT/products/stocksBulk product stock update
POST/ticketCreates a new trouble ticket
POST/ticket/{ticketId}/messageAdd new message to trouble ticket
GET/ticket/{ticketId}/messagesGet trouble ticket messages
PUT/ticket/{ticketId}/statusUpdate trouble ticket status
GET/ticketsGet customers trouble tickets

Questions

Does the BrandLovers Marketplace API V1 API need an API key?

Yes. The BrandLovers Marketplace API V1 API uses API key authentication; the documentation explains how to get credentials.

Does the BrandLovers Marketplace API V1 API support HTTPS?

Yes, the BrandLovers Marketplace API V1 API is served over HTTPS.

How many endpoints does the BrandLovers Marketplace API V1 API have?

Its OpenAPI description lists 36 endpoints in version 1.0.0. All of them are shown on this page.

What are alternatives to the BrandLovers Marketplace API V1 API?

Other Shopping APIs include Etsy, eBay, Flipkart Marketplace, Inventory Management, Intel Product Catalogue Service.

Compare alternatives →

Listed from APIs.guru (CC0).