Skip to content

BeezUP Merchant API API

by beezup.com

API keyHTTPSShopping
Open documentation ↗

Overview

# The REST API of BeezUP system ## Overview The REST APIs provide programmatic access to read and write BeezUP data. Basically, with this API you will be able to do everything like you were with your browser on https://go.beezup.com ! The main features are: - Register and manage your account - Create and manage and share your stores with your friends/co-workers. - Import your product catalog and schedule the auto importation - Search the channels your want to use - Configure your channels for your catalogs to export your product information: - cost and general settings - category and columns mappings - your will be able to create and manage your custom column - put in place exlusion filters based on simple conditions on your product data - override product values - get product vision for a channel catalog scope - Analyze and optimize your performance of your catalogs on all yours channels with different type of reportings by day, channel, category and by product. - Automatize your optimisation by using rules! - And of course... Manage your orders harvested from all your marketplaces: - Synchronize your orders in an uniformized way - Get the available actions and update the order status - ...and more! ## Authentication credentials The public API with the base path **/v2/public** have been put in place to give you an entry point to our system for the user registration, login and lost password. The public API does not require any credentials. We give you the some public list of values and public channels for our public commercial web site [www.beezup.com](http://www.beezup.com). The user API with the base path **/v2/user** requires a token which is available on this page: https://go.beezup.com/Account/MyAccount ## Things to keep in mind ### API Rate Limits - The BeezUP REST API is limited to 100 calls/minute. ### Media type The default media type for requests and responses is application/json. Where noted, some operations support other content types. If no additional content type is mentioned for a specific operation, then the media type is application/json. ### Required content type The required and default encoding for the request and responses is UTF8. ### Required date time format All our date time are formatted in ISO 8601 format: 2014-06-24T16:25:00Z. ### Base URL The Base URL of the BeezUP API Order Management REST API conforms to the following template. https://api.beezup.com All URLs returned by the BeezUP API are relative to this base URL, and all requests to the REST API must use this base URL template. You can test our API on https://api-docs.beezup.com/swagger-ui\\ You can contact us on [gitter, #BeezUP/API](https://gitter.im/BeezUP/API)

BeezUP Merchant API is a shopping API from beezup.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 224 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Shopping
Base URL
https://api.beezup.com
Version
2.0
Endpoints
224
Spec updated
2023-03-06

Make a first request

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

cURL
curl -X GET "https://api.beezup.com/orders/v3/lov/orderManagementReadyMarketplaceBusinessCode" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://api.beezup.com/orders/v3/lov/orderManagementReadyMarketplaceBusinessCode", {
  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.beezup.com/orders/v3/lov/orderManagementReadyMarketplaceBusinessCode",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
POST/orders/v3/batches/changeOrdersSend a batch of operations to change your marketplace Order information: accept, ship, etc. (max 100 items per call)
POST/orders/v3/batches/changeOrders/{changeOrderType}Send a batch of operations to change your marketplace Order information: accept, ship, etc. (max 100 items per call)
POST/orders/v3/batches/clearMerchantOrderInfosSend a batch of operations to clear an Order's merchant information (max 100 items per call)
POST/orders/v3/batches/setMerchantOrderInfosSend a batch of operations to set an Order's merchant information (max 100 items per call)
POST/orders/v3/harvestSend harvest request to all your marketplaces
POST/orders/v3/list/fullGet a paginated list of all Orders with all Order and Order Item(s) properties
POST/orders/v3/list/lightGet a paginated list of all Orders without details
GET/orders/v3/lov/orderManagementReadyMarketplaceBusinessCodeGet the list of MarketplaceBusinessCode ready for Order Management
GET/orders/v3/statusGet current synchronization status between your marketplaces and BeezUP accounts
POST/orders/v3/{marketplaceTechnicalCode}/{accountId}/harvestSend harvest request for an Account
GET/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}Get full Order and Order Item(s) properties
POST/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/clearMerchantOrderInfoClear an Order's merchant information
POST/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/harvestSend harvest request for a single Order
GET/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/historyGet an Order's harvest and change history
GET/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/history/{orderChangeExecutionUUID}Get the order change reporting
POST/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/setMerchantOrderInfoSet an Order's merchant information
POST/orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/{changeOrderType}Change your marketplace Order Information (accept, ship, etc.)
GET/v2/public/channels/Get public channel index
GET/v2/public/channels/{countryIsoCode}The channel list for one country
GET/v2/public/lov/Get all list names
GET/v2/public/lov/{listName}Get the list of values related to this list name
POST/v2/public/security/loginLogin
POST/v2/public/security/lostpasswordLost password
POST/v2/public/security/registerUser Registration
GET/v2/user/analytics/Get the Analytics API operation index
POST/v2/user/analytics/reports/bydayGet the report by day for a StoreId
GET/v2/user/analytics/tracking/statusGet the global synchronization status of clicks and orders
GET/v2/user/analytics/{storeId}Get the Analytics API operation index for one store
POST/v2/user/analytics/{storeId}/optimisations/all/{actionName}Optimise all products
POST/v2/user/analytics/{storeId}/optimisations/bycategory/{catalogCategoryId}/{actionName}Optimise products by category
POST/v2/user/analytics/{storeId}/optimisations/bychannel/{channelId}/{actionName}Optimise products by channel
POST/v2/user/analytics/{storeId}/optimisations/byproduct/{productId}/{actionName}Optimise product
POST/v2/user/analytics/{storeId}/optimisations/copyCopy product optimisations between 2 channels
POST/v2/user/analytics/{storeId}/optimisations/{actionName}Optimise products by page
POST/v2/user/analytics/{storeId}/reports/bycategoryGet the report by category
POST/v2/user/analytics/{storeId}/reports/bychannelGet the report by channel
POST/v2/user/analytics/{storeId}/reports/bydayGet the report by day for a StoreId
POST/v2/user/analytics/{storeId}/reports/byproductGet the report by product
GET/v2/user/analytics/{storeId}/reports/filtersGet report filter list for the given store
GET/v2/user/analytics/{storeId}/reports/filters/{reportFilterId}Get the report filter description
PUT/v2/user/analytics/{storeId}/reports/filters/{reportFilterId}Save the report filter
DELETE/v2/user/analytics/{storeId}/reports/filters/{reportFilterId}Delete the report filter
GET/v2/user/analytics/{storeId}/rulesGets the list of rules for a given store
POST/v2/user/analytics/{storeId}/rulesRule creation
GET/v2/user/analytics/{storeId}/rules/executionsGet the rules execution history
POST/v2/user/analytics/{storeId}/rules/runRun all rules for this store
GET/v2/user/analytics/{storeId}/rules/{ruleId}Gets the rule
PATCH/v2/user/analytics/{storeId}/rules/{ruleId}Update Rule
DELETE/v2/user/analytics/{storeId}/rules/{ruleId}Delete Rule
POST/v2/user/analytics/{storeId}/rules/{ruleId}/disableDisable rule
POST/v2/user/analytics/{storeId}/rules/{ruleId}/enableEnable rule
POST/v2/user/analytics/{storeId}/rules/{ruleId}/movedownMove the rule down
POST/v2/user/analytics/{storeId}/rules/{ruleId}/moveupMove the rule up
POST/v2/user/analytics/{storeId}/rules/{ruleId}/runRun rule
GET/v2/user/analytics/{storeId}/tracking/clicksGet the latest tracked clicks
GET/v2/user/analytics/{storeId}/tracking/externalordersGet the latest tracked external orders
GET/v2/user/analytics/{storeId}/tracking/ordersGet the latest tracked orders
GET/v2/user/analytics/{storeId}/tracking/statusGet the synchronization status of clicks and orders of a store
GET/v2/user/catalogs/Get the index of the catalog API
GET/v2/user/catalogs/beezupColumnsGet the BeezUP columns
GET/v2/user/catalogs/importationsGet the latest catalog importation reporting for all your stores
GET/v2/user/catalogs/{storeId}Get the index of the catalog API for this store
GET/v2/user/catalogs/{storeId}/autoImportGet the auto import configuration
DELETE/v2/user/catalogs/{storeId}/autoImportDelete Auto Import
POST/v2/user/catalogs/{storeId}/autoImport/activateActivate the auto importation of the last successful manual catalog importation.
POST/v2/user/catalogs/{storeId}/autoImport/pausePause Auto Import
POST/v2/user/catalogs/{storeId}/autoImport/resumeResume Auto Import
POST/v2/user/catalogs/{storeId}/autoImport/scheduling/intervalConfigure Auto Import Interval
POST/v2/user/catalogs/{storeId}/autoImport/scheduling/schedulesConfigure Auto Import Schedules
POST/v2/user/catalogs/{storeId}/autoImport/startStart Auto Import Manually
GET/v2/user/catalogs/{storeId}/catalogColumnsGet catalog column list
POST/v2/user/catalogs/{storeId}/catalogColumns/{columnId}/renameChange Catalog Column User Name
GET/v2/user/catalogs/{storeId}/categoriesGet category list
GET/v2/user/catalogs/{storeId}/customColumnsGet custom column list
POST/v2/user/catalogs/{storeId}/customColumns/computeExpressionCompute the expression for this catalog.
PUT/v2/user/catalogs/{storeId}/customColumns/{columnId}Create or replace a custom column
DELETE/v2/user/catalogs/{storeId}/customColumns/{columnId}Delete custom column
GET/v2/user/catalogs/{storeId}/customColumns/{columnId}/expressionGet the encrypted custom column expression
PUT/v2/user/catalogs/{storeId}/customColumns/{columnId}/expressionChange custom column expression
POST/v2/user/catalogs/{storeId}/customColumns/{columnId}/renameChange Custom Column User Name
GET/v2/user/catalogs/{storeId}/importationsGet the latest catalog importation reporting
POST/v2/user/catalogs/{storeId}/importations/startStart Manual Import
GET/v2/user/catalogs/{storeId}/importations/{executionId}Get the importation status
POST/v2/user/catalogs/{storeId}/importations/{executionId}/cancelCancel importation
GET/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumnsGet detected catalog columns during this importation.
POST/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}Configure catalog column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/ignoreIgnore Column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/mapMap catalog column to a BeezUP column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/reattendReattend Column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/unmapUnmap catalog column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/commitCommit Importation
POST/v2/user/catalogs/{storeId}/importations/{executionId}/commitColumnsCommit columns
POST/v2/user/catalogs/{storeId}/importations/{executionId}/configureRemainingCatalogColumnsConfigure remaining catalog columns
GET/v2/user/catalogs/{storeId}/importations/{executionId}/customColumnsGet custom columns currently place in this importation
PUT/v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}Create or replace a custom column
DELETE/v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}Delete Custom Column
GET/v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}/expressionGet the encrypted custom column expression in this importation
POST/v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}/mapMap custom column to a BeezUP column
POST/v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}/unmapUnmap custom column
GET/v2/user/catalogs/{storeId}/importations/{executionId}/productSamples/{productSampleIndex}Get the product sample related to this importation with all columns (catalog and custom)

Showing the first 100 of 224 endpoints; the full list is in the documentation.

Questions

Does the BeezUP Merchant API API need an API key?

Yes. The BeezUP Merchant API API uses API key authentication; the documentation explains how to get credentials.

Does the BeezUP Merchant API API support HTTPS?

Yes, the BeezUP Merchant API API is served over HTTPS.

How many endpoints does the BeezUP Merchant API API have?

Its OpenAPI description lists 224 endpoints in version 2.0. The first 100 are shown on this page.

What are alternatives to the BeezUP Merchant API API?

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

Compare alternatives →

Listed from APIs.guru (CC0).