When listing an item with the APIs, become familiar with the following general API information:
-
List one item
Use the AddItem or AddFixedPriceItem call. Both calls return the item ID (the unique identifier for the new listing), along with the listing fees that the seller can expect to pay for the listing. Refer to Fees for more information.
Because GetItem does not return an item's listing fees, you should save the fees returned from AddItem if you want to keep a record of the expected fees. The GetAccount call can also be used to retrieve all fees to a seller's account.
-
List multiple items
Use the AddItems call to list up to five items at a time.
Note: For information about the bulk creation of listings, refer to the Sell Feed API and/or the Inventory API.
-
Test a listing before publishing
The VerifyAddItem or VerifyAddFixedPriceItem calls can be used. Each of these calls:
- Has the same request payload as its standard Add counterpart;
- Triggers the same errors and/or warnings (if any);
- Returns the expected listing fees;
- However, the listing will not be published.
Review the VerifyAddItem or VerifyAddFixedPriceItem response to determine if a Message node is included. If so, it may indicate that an AddItem attempt will be unsuccessful. For additional information, refer to VerifyAddItem Returns Success with No Errors, but AddItem Returns Failure with Errors.
If the VerifyAddItem or VerifyAddFixedPriceItem call is successful (i.e., no errors/warnings are returned,) then the application can use the same
ItemType
object again, unchanged, with the AddItem or AddFixedPriceItem calls. -
Mutliple-variations
Both AddItem and ReviseItem support auctions and fixed-price listings. However, only AddFixedPriceItem and ReviseFixedPriceItem support multiple variations in fixed-price listings. When creating multiple-variation listings with the Trading API, AddFixedPriceItem and ReviseFixedPriceItem must be used.
-
Fees
For information about fees associated with listing items, refer to Fees.
-
Seller limits
GetMyeBaySelling returns seller limit information for the seller if the seller is subject to seller limits. Refer to Selling Limits for additional information.
The remaining quantity of items that may be listed (i.e., Summary.QuantityLimitRemaining,) and the remaining listing value (i.e., Summary.AmountLimitRemaining,) are returned by GetMyeBaySelling. If these limits are exceeded, any subsequent AddItem, AddItems, or AddFixedPriceItem calls will fail. To determine if you remain within limits, call GetMyeBaySelling before calling AddItem, AddItems, or AddFixedPriceItem.
-
Cross-border transactions
Sellers who engage in cross-border transactions on marketplaces that require a recoupment agreement must agree to the recoupment terms before calling any of the Add— or VerifyAdd— family of calls. This agreement allows eBay to reimburse a buyer during a dispute and then recoup the cost from the seller.
Refer to Cross-border Trading for additional information.