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
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-06
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.beezup.com/orders/v3/lov/orderManagementReadyMarketplaceBusinessCode" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"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);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
| Method | Path | What it does |
|---|---|---|
| POST | /orders/v3/batches/changeOrders | Send 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/clearMerchantOrderInfos | Send a batch of operations to clear an Order's merchant information (max 100 items per call) |
| POST | /orders/v3/batches/setMerchantOrderInfos | Send a batch of operations to set an Order's merchant information (max 100 items per call) |
| POST | /orders/v3/harvest | Send harvest request to all your marketplaces |
| POST | /orders/v3/list/full | Get a paginated list of all Orders with all Order and Order Item(s) properties |
| POST | /orders/v3/list/light | Get a paginated list of all Orders without details |
| GET | /orders/v3/lov/orderManagementReadyMarketplaceBusinessCode | Get the list of MarketplaceBusinessCode ready for Order Management |
| GET | /orders/v3/status | Get current synchronization status between your marketplaces and BeezUP accounts |
| POST | /orders/v3/{marketplaceTechnicalCode}/{accountId}/harvest | Send 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}/clearMerchantOrderInfo | Clear an Order's merchant information |
| POST | /orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/harvest | Send harvest request for a single Order |
| GET | /orders/v3/{marketplaceTechnicalCode}/{accountId}/{beezUPOrderId}/history | Get 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}/setMerchantOrderInfo | Set 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/login | Login |
| POST | /v2/public/security/lostpassword | Lost password |
| POST | /v2/public/security/register | User Registration |
| GET | /v2/user/analytics/ | Get the Analytics API operation index |
| POST | /v2/user/analytics/reports/byday | Get the report by day for a StoreId |
| GET | /v2/user/analytics/tracking/status | Get 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/copy | Copy product optimisations between 2 channels |
| POST | /v2/user/analytics/{storeId}/optimisations/{actionName} | Optimise products by page |
| POST | /v2/user/analytics/{storeId}/reports/bycategory | Get the report by category |
| POST | /v2/user/analytics/{storeId}/reports/bychannel | Get the report by channel |
| POST | /v2/user/analytics/{storeId}/reports/byday | Get the report by day for a StoreId |
| POST | /v2/user/analytics/{storeId}/reports/byproduct | Get the report by product |
| GET | /v2/user/analytics/{storeId}/reports/filters | Get 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}/rules | Gets the list of rules for a given store |
| POST | /v2/user/analytics/{storeId}/rules | Rule creation |
| GET | /v2/user/analytics/{storeId}/rules/executions | Get the rules execution history |
| POST | /v2/user/analytics/{storeId}/rules/run | Run 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}/disable | Disable rule |
| POST | /v2/user/analytics/{storeId}/rules/{ruleId}/enable | Enable rule |
| POST | /v2/user/analytics/{storeId}/rules/{ruleId}/movedown | Move the rule down |
| POST | /v2/user/analytics/{storeId}/rules/{ruleId}/moveup | Move the rule up |
| POST | /v2/user/analytics/{storeId}/rules/{ruleId}/run | Run rule |
| GET | /v2/user/analytics/{storeId}/tracking/clicks | Get the latest tracked clicks |
| GET | /v2/user/analytics/{storeId}/tracking/externalorders | Get the latest tracked external orders |
| GET | /v2/user/analytics/{storeId}/tracking/orders | Get the latest tracked orders |
| GET | /v2/user/analytics/{storeId}/tracking/status | Get 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/beezupColumns | Get the BeezUP columns |
| GET | /v2/user/catalogs/importations | Get 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}/autoImport | Get the auto import configuration |
| DELETE | /v2/user/catalogs/{storeId}/autoImport | Delete Auto Import |
| POST | /v2/user/catalogs/{storeId}/autoImport/activate | Activate the auto importation of the last successful manual catalog importation. |
| POST | /v2/user/catalogs/{storeId}/autoImport/pause | Pause Auto Import |
| POST | /v2/user/catalogs/{storeId}/autoImport/resume | Resume Auto Import |
| POST | /v2/user/catalogs/{storeId}/autoImport/scheduling/interval | Configure Auto Import Interval |
| POST | /v2/user/catalogs/{storeId}/autoImport/scheduling/schedules | Configure Auto Import Schedules |
| POST | /v2/user/catalogs/{storeId}/autoImport/start | Start Auto Import Manually |
| GET | /v2/user/catalogs/{storeId}/catalogColumns | Get catalog column list |
| POST | /v2/user/catalogs/{storeId}/catalogColumns/{columnId}/rename | Change Catalog Column User Name |
| GET | /v2/user/catalogs/{storeId}/categories | Get category list |
| GET | /v2/user/catalogs/{storeId}/customColumns | Get custom column list |
| POST | /v2/user/catalogs/{storeId}/customColumns/computeExpression | Compute 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}/expression | Get the encrypted custom column expression |
| PUT | /v2/user/catalogs/{storeId}/customColumns/{columnId}/expression | Change custom column expression |
| POST | /v2/user/catalogs/{storeId}/customColumns/{columnId}/rename | Change Custom Column User Name |
| GET | /v2/user/catalogs/{storeId}/importations | Get the latest catalog importation reporting |
| POST | /v2/user/catalogs/{storeId}/importations/start | Start Manual Import |
| GET | /v2/user/catalogs/{storeId}/importations/{executionId} | Get the importation status |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/cancel | Cancel importation |
| GET | /v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns | Get 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}/ignore | Ignore Column |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/map | Map catalog column to a BeezUP column |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/reattend | Reattend Column |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/catalogColumns/{columnId}/unmap | Unmap catalog column |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/commit | Commit Importation |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/commitColumns | Commit columns |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/configureRemainingCatalogColumns | Configure remaining catalog columns |
| GET | /v2/user/catalogs/{storeId}/importations/{executionId}/customColumns | Get 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}/expression | Get the encrypted custom column expression in this importation |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}/map | Map custom column to a BeezUP column |
| POST | /v2/user/catalogs/{storeId}/importations/{executionId}/customColumns/{columnId}/unmap | Unmap 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.
Similar shopping APIs
Compare alternatives →Etsy
ShoppingManage shop and interact with listings
eBay
ShoppingSell and Buy on eBay
Flipkart Marketplace
ShoppingProduct listing management, Order Fulfilment in the Flipkart Marketplace
Inventory Management
ShoppingMaintaining up-to-date inventory for your items on Walmart.com ensures a great experience for your customers and greater sales opportunities for you.
Intel Product Catalogue Service
ShoppingThis is the documentation for PIM Micro services. In order to use this tool you need to have Basic Auth credentials and a client id. If you dont have one, please make sure to request one by sending an email to the PIM MS team: [[email protected]](mailto:[email protected]?subject=PIMServices)
Item API
ShoppingPlease make sure you use the correct version of the APIs for your use case. To find out the appropriate version, go to the API Docs drop down on the menu.
Listed from APIs.guru (CC0).