Imports are a great way to save time and bulk edit products in your account using the template provided. offers methods to manually upload files via the app itself however you can also automate the import using your own systems and the xSellco API. 

This help file will guide you through automating your imports via the API.

Before you start 

  • You’ll need an Admin login to If you don’t have an Admin login, you can request one from an Admin user within your business.
  • You’ll need to be on the Ultimate or Extreme plan to access this feature. To find out more information, click here.

Note: APIs imports are quite complex to set up and would require some technical background. If you're not comfortable with it, it might be best to use manual imports instead.

Related Videos

  • For a video discussing the API and examples of its implementation, click here.

01 What is an API?

An API is a method of you (or rather your small script/program) talking to another and requesting something. In this case, our API allows you to connect to and request an import template with all your pricing data or to upload a file to your account.

The most common approach would be to have a script generate a file from your own system in format and then upload it to your account.

Note: It’s recommended that files should not be uploaded more often than once every 30 minutes (or less often if you have a very large number of listings). Uploading or downloading files too regularly will slow down processing on your account. 

02 What is an import used for?

Repricer imports are a great method of quickly reviewing and updating your product information. The most common use of the import is to update Min Max prices and Repricing Rules but it can also be used to set fees and read other data such as ASIN, Quantity, and Fulfillment Type.

There are currently three types of imports available with

Note: at the moment, only Amazon format files are available via the API.

03 How to get started?

We would highly recommend you to read the three articles below to get started with the API:

With all the instructions in these documents, you should be able to create your own call to the API. 

04 Troubleshooting the API

Due to the complexity of the API setup and the various languages you can use to code,  it's sometimes hard to pinpoint exactly what the issue is if you're having troubles with your connection. Anytime a call fails, an error message is an output, and below are the most common errors:

  • Your authentication credentials are invalid
    This indicates that you have not given the correct username/password to access the API from your account. The logins should be the same used to login to your account.

  • The API is limited to clients in trial or paying
    This indicates that you do not have access to the API. The API is limited to Ultimate and Extreme clients.

  • Missing mandatory header column
    The file format supplied through the API should be the same as you would use via the screen. This error indicates the file format is incorrect and you should review it.

  • You have reached the maximum requests limit
    This indicates that you have made too many requests. You can try again later and slow down your uploads or downloads to avoid this in the future.

  • Non-admin credentials used
    This indicates that you're not using admin credentials. You must use the admin credentials associated with your account.

  • Previous file is still being processed
    This indicates that the previous file you uploaded is still processing. Leave it a minute then try again.

  • This is not a valid file
    This indicates that the file you are trying to upload has not been found. Check the filename and folder in your call match the location of the file.

Further Readings

Interested in learning more about changing your Repricing Rule? Click here.

If you wanted to find out more about Minimum and Maximum prices, click here.