Listing
此内容尚不支持你的语言。
Listing API allows you to download listing data and update listing data in Teapplix:
-
GET - based on certain criteria, download listing object from your Teapplix account. In the below list of criteria, at least one must be provided. Otherwise error will be returned. Notice that this GET query has no cursor capability and only return max 5000 results.
- Channel — which marketplace or shopping cart’s listing we want
- SellerId — if you linked multiple accounts from the same channel into Teapplix, SellerId typically names one of those accounts. In the case of eBay, Amazon, this will be the seller id or merchant id. In the case of other channels, this typically is the “store key” assigned in Teapplix when you linked the channel account.
- SellerSKU — Seller SKU you assigned on the Marketplace or Shopping Cart.
- TeapplixSKU — Mapped SKU in Teapplix. If you did not do any mapping, this is the same as SellerSKU
- WarehouseId — which warehouse id the listing is assigned to. Specifying this parameter will fetch only listings assigned to that particular warehouse id. This is an integer.
-
PUT - based on provided key, update certain fields for listing object in your Teapplix account.
GET Request
Query parameters
| Property | Type | Description | Constraints |
|---|---|---|---|
StoreType |
string | Listing marketplace. Amazon = 'amazon'; Amazon Vendor = 'amzv'; eBay = 'ebay'; cart marketplaces use their own store type code. | |
SellerId |
string | For amazon/amzv: Amazon merchant ID. For ebay: ebay_api.username. Ignored for cart marketplaces. | |
SellerSKU |
string | Seller SKU | |
TeapplixSKU |
string | Teapplix SKU | |
WarehouseId |
integer | Warehouse ID | |
ListingType |
string | Listing Type, only available if StoreType is 'amazon' or 'amzv'. Possible values: 'DEFAULT', 'AMAZON_NA'. |
GET Response - 200
Listings result
| Property | Type | Description | Constraints |
|---|---|---|---|
Listings |
Listing[] | Required |
Listing
| Property | Type | Description | Constraints |
|---|---|---|---|
StoreType |
string | Store Listing is From | One of: 3dcart, 3plcentral, Manual, RMA, aafes, aafes2, academysports, acehardware, acenda, amazon, amzv, ashley, ashley2, barnesnoble, basspro, belk, belkb2b, bestbuy, bestbuy2bca, bigcommerce, bonanza, ca2, campwrld, chewy, commercehub, corecommerce, costco, costcoca, costcojp, cratejoy, creloaded, cscart, cymax, doitbest, dsco, ebay, essentialhub, etsy, fabfitfun, fleetfarm, generic, goflow, googlec, googleexpress, groupongoods, hdpro, hdsupply, hdsupplyso, homedepot, homedepot2b, homedepotca, homedepotso, homehardware, houzz, hsn, jcpenney, kohls, lampsplus, lowes, lowes2b, lowesca, lowesm, macys, magento, magento2, menards, michaels, mirakl, newegg, neweggApi, neweggb2b, nfm, northerntool, opencart, opensky, orgill, oscommerce, paypal, pcrs, petco, petsmart, pinnacle, prestashop, qbi, qbo, qbr, quill, qvc, rakuten, reverb, ruegilt, samsclub, sears, shein, shipstation, shopify, sparkpay, squarespace, staplesadvca, staplesca, staplesca2b, supplieroasis, target, target2b, temu, tiktok, tongtool, tophatter, tractorsupply, tractorsupply2b, volusion, walmart, walmartdsv, walmartpo, wayfair, wish, woocommerce, wsonoma, xcart, xcart5, yahoo, zencart, zoro |
StoreKey |
string | Unique id for each store type, filled for StoreType other than ebay or amazon | Pattern: (^$)|[a-zA-Z0-9]{3} |
VSAccountID |
string | ||
SellerId |
string | For StoreType ebay or amazon only | |
ListingTitle |
string | Listing Title | Max-Length: 255 |
TeapplixSKU |
string | Teapplix SKU | |
SellerSKU |
string | Seller SKU | |
ListingId |
string | Listing Id | |
ImageUrl |
string | Image Url | |
ListingType |
string | Listing Type | |
QtyOnMarketplace |
integer | Quantity On Marketplace | |
QtyAvailable |
integer | Quantity Available | |
ChannelWarehouseId |
string | Channel Warehouse Id | |
WarehouseId |
integer | Warehouse Id | |
altListingId |
string | Alternative listing id | |
UPC |
string | UPC | |
Open |
integer | Product Open flag | |
handlingTime |
string | Handling Time | |
brand |
string | Brand | |
manufacturer |
string | Manufacturer | |
asin |
string | ASIN |
GET Response - 400
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
GET Response - 401
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
GET Response - 500
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
PUT Request
Listing update request
'APIToken' header should be included in each request
| Property | Type | Description | Constraints |
|---|---|---|---|
Listings |
Listing update entry[] |
Listing update entry
One listing row to update on PUT /Listing. Inherits the composite-key fields (StoreType, StoreKey, SellerId, ListingId, ChannelWarehouseId) from ListingKey. At least one of WarehouseId or Discontinued must be provided; both may be provided together to apply both updates in a single call. ListingId is the primary row identifier; SellerSKU is accepted only as a deprecated fallback when ListingId is empty.
| Property | Type | Description | Constraints |
|---|---|---|---|
StoreType |
string | Marketplace identifier. Amazon = 'amazon'; Amazon Vendor = 'amzv'; eBay = 'ebay'; cart marketplaces use their own store type code (e.g. mirakl, bigcommerce, shopify). | RequiredOne of: 3dcart, 3plcentral, Manual, RMA, aafes, aafes2, academysports, acehardware, acenda, amazon, amzv, ashley, ashley2, barnesnoble, basspro, belk, belkb2b, bestbuy, bestbuy2bca, bigcommerce, bonanza, ca2, campwrld, chewy, commercehub, corecommerce, costco, costcoca, costcojp, cratejoy, creloaded, cscart, cymax, doitbest, dsco, ebay, essentialhub, etsy, fabfitfun, fleetfarm, generic, goflow, googlec, googleexpress, groupongoods, hdpro, hdsupply, hdsupplyso, homedepot, homedepot2b, homedepotca, homedepotso, homehardware, houzz, hsn, jcpenney, kohls, lampsplus, lowes, lowes2b, lowesca, lowesm, macys, magento, magento2, menards, michaels, mirakl, newegg, neweggApi, neweggb2b, nfm, northerntool, opencart, opensky, orgill, oscommerce, paypal, pcrs, petco, petsmart, pinnacle, prestashop, qbi, qbo, qbr, quill, qvc, rakuten, reverb, ruegilt, samsclub, sears, shein, shipstation, shopify, sparkpay, squarespace, staplesadvca, staplesca, staplesca2b, supplieroasis, target, target2b, temu, tiktok, tongtool, tophatter, tractorsupply, tractorsupply2b, volusion, walmart, walmartdsv, walmartpo, wayfair, wish, woocommerce, wsonoma, xcart, xcart5, yahoo, zencart, zoro |
StoreKey |
string | For StoreType 'amazon' or 'amzv': the Amazon marketplace country code (e.g. US, CA, UK). For cart marketplaces: the cart store key. Not used for StoreType 'ebay'. | Pattern: (^$)|[a-zA-Z0-9]{2,7} |
SellerId |
string | For StoreType 'amazon' or 'amzv': the Amazon Selling Partner ID. For StoreType 'ebay': the Username. Ignored for cart marketplaces. | |
ListingId |
string | Listing ID on the marketplace. | |
ChannelWarehouseId |
string | Channel warehouse ID as reported by the marketplace. Optional; defaults to empty when the marketplace does not report one. | |
SellerSKU |
string | DEPRECATED: use ListingId. Seller SKU is accepted only as a fallback row identifier when ListingId is empty. | |
WarehouseId |
integer | New Warehouse ID to set. At least one of WarehouseId or Discontinued must be present. | |
Price |
number | New listing price to set. At least one of WarehouseId, Price, or Discontinued must be present. | |
Discontinued |
integer | Set to 1 to discontinue or 0 to re-activate the listing. At least one of WarehouseId, Price, or Discontinued must be present. | One of: 0, 1 |
PUT Response - 200
Listing Update Result
| Property | Type | Description | Constraints |
|---|---|---|---|
Listings |
Listing To Update[] | Listing Results |
Listing To Update
| Property | Type | Description | Constraints |
|---|---|---|---|
StoreType |
string | Order type | One of: 3dcart, 3plcentral, Manual, RMA, aafes, aafes2, academysports, acehardware, acenda, amazon, amzv, ashley, ashley2, barnesnoble, basspro, belk, belkb2b, bestbuy, bestbuy2bca, bigcommerce, bonanza, ca2, campwrld, chewy, commercehub, corecommerce, costco, costcoca, costcojp, cratejoy, creloaded, cscart, cymax, doitbest, dsco, ebay, essentialhub, etsy, fabfitfun, fleetfarm, generic, goflow, googlec, googleexpress, groupongoods, hdpro, hdsupply, hdsupplyso, homedepot, homedepot2b, homedepotca, homedepotso, homehardware, houzz, hsn, jcpenney, kohls, lampsplus, lowes, lowes2b, lowesca, lowesm, macys, magento, magento2, menards, michaels, mirakl, newegg, neweggApi, neweggb2b, nfm, northerntool, opencart, opensky, orgill, oscommerce, paypal, pcrs, petco, petsmart, pinnacle, prestashop, qbi, qbo, qbr, quill, qvc, rakuten, reverb, ruegilt, samsclub, sears, shein, shipstation, shopify, sparkpay, squarespace, staplesadvca, staplesca, staplesca2b, supplieroasis, target, target2b, temu, tiktok, tongtool, tophatter, tractorsupply, tractorsupply2b, volusion, walmart, walmartdsv, walmartpo, wayfair, wish, woocommerce, wsonoma, xcart, xcart5, yahoo, zencart, zoro |
StoreKey |
string | Unique id for each store type, filled for StoreType other than ebay or amazon | Pattern: (^$)|[a-zA-Z0-9]{3} |
SellerSKU |
string | Seller SKU | |
SellerId |
string | ||
ListingId |
string | Listing Id | |
ChannelWarehouseId |
string | Channel warehouse ID as reported by the marketplace; empty when the marketplace does not report one. | |
Status |
string | Status | |
Message |
string | Status Message |
PUT Response - 400
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
PUT Response - 401
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
PUT Response - 403
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
PUT Response - 500
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
DELETE Request
Listing Key
Composite key used to identify a row in the listing / listing_variation tables across all marketplaces. The full key is StoreType + StoreKey + SellerId + ListingId + ChannelWarehouseId. StoreKey and SellerId roles vary by marketplace — see each field's description.
| Property | Type | Description | Constraints |
|---|---|---|---|
StoreType |
string | Marketplace identifier. Amazon = 'amazon'; Amazon Vendor = 'amzv'; eBay = 'ebay'; cart marketplaces use their own store type code (e.g. mirakl, bigcommerce, shopify). | RequiredOne of: 3dcart, 3plcentral, Manual, RMA, aafes, aafes2, academysports, acehardware, acenda, amazon, amzv, ashley, ashley2, barnesnoble, basspro, belk, belkb2b, bestbuy, bestbuy2bca, bigcommerce, bonanza, ca2, campwrld, chewy, commercehub, corecommerce, costco, costcoca, costcojp, cratejoy, creloaded, cscart, cymax, doitbest, dsco, ebay, essentialhub, etsy, fabfitfun, fleetfarm, generic, goflow, googlec, googleexpress, groupongoods, hdpro, hdsupply, hdsupplyso, homedepot, homedepot2b, homedepotca, homedepotso, homehardware, houzz, hsn, jcpenney, kohls, lampsplus, lowes, lowes2b, lowesca, lowesm, macys, magento, magento2, menards, michaels, mirakl, newegg, neweggApi, neweggb2b, nfm, northerntool, opencart, opensky, orgill, oscommerce, paypal, pcrs, petco, petsmart, pinnacle, prestashop, qbi, qbo, qbr, quill, qvc, rakuten, reverb, ruegilt, samsclub, sears, shein, shipstation, shopify, sparkpay, squarespace, staplesadvca, staplesca, staplesca2b, supplieroasis, target, target2b, temu, tiktok, tongtool, tophatter, tractorsupply, tractorsupply2b, volusion, walmart, walmartdsv, walmartpo, wayfair, wish, woocommerce, wsonoma, xcart, xcart5, yahoo, zencart, zoro |
StoreKey |
string | For StoreType 'amazon' or 'amzv': the Amazon marketplace country code (e.g. US, CA, UK). For cart marketplaces: the cart store key. Not used for StoreType 'ebay'. | Pattern: (^$)|[a-zA-Z0-9]{2,7} |
SellerId |
string | For StoreType 'amazon' or 'amzv': the Amazon Selling Partner ID. For StoreType 'ebay': the Username. Ignored for cart marketplaces. | |
ListingId |
string | Listing ID on the marketplace. | |
ChannelWarehouseId |
string | Channel warehouse ID as reported by the marketplace. Optional; defaults to empty when the marketplace does not report one. |
DELETE Response - 200
CountedSuccessMessage
SuccessMessage variant that reports how many items were acted on by the request (created, deleted, cancelled, reviewed, submitted, etc.).
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | DEPRECATED: always true on this envelope. Read Status instead. Will be removed in the next API major version. | |
Status |
string | Per-domain success discriminator (e.g. 'Cancelled', 'Reviewed', 'Submitted', 'Updated', 'Purchased', 'Created', 'Deleted'). Subclasses constrain this with @Enum. | Required |
Message |
string | Human-readable result message. | |
Description |
string[] | Detailed description | |
Count |
integer | Number of items acted on by the request (e.g. created, deleted, cancelled, reviewed, submitted). | Required |
DELETE Response - 400
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
DELETE Response - 401
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
DELETE Response - 404
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |
DELETE Response - 500
Message
| Property | Type | Description | Constraints |
|---|---|---|---|
Success |
boolean | Always false on this envelope. Message is the error envelope (4xx/5xx); Success is kept on the wire so legacy clients can branch on it without parsing the HTTP status. | Required |
Code |
integer | Indicate error code. Codes list and description are located on help page https://www.teapplix.com/help/?page_id=7115 | |
Message |
string | Message typically associated with errors | |
Description |
string[] | Detailed description |

