Selecting products
Selecting products to sell
The first step to building out your Rye integration is to identify what products you would like to sell. At this stage, you don’t need to worry about any technical details.
For each product you want to sell, you’ll need to record the URL the product is located at alongside the URL of the store. Compile this information into a format that your technical implementation team will be comfortable working with. If you don’t have a file format in mind, then our recommendation is to use a CSV file with the following structure:
Product URL | Store URL |
---|---|
https://www.allbirds.com/products/womens-tree-runners | https://www.allbirds.com/ |
https://kith.com/products/khm031515-413 | https://kith.com/ |
https://kith.com/products/khm031517-302 | https://kith.com/ |
Once you have compiled this list of products you are ready to move on to the next step.
I know exactly what products I want to sell
I know exactly what products I want to sell
Produce a listing of the products you want to sell in a CSV file with the structure outlined above, and proceed to the next step.
I'm not sure what products I want to sell
I'm not sure what products I want to sell
After signing up with Rye, you’ll get access to a CSV of ~15,000 products already available within our product catalog. This CSV can be found in the Developer Resources section of the Rye Console. The list also contains some additional information that can guide your product selection workflow, such as category information.
Picking the right API(s)
Rye offers two different APIs depending on your use case: the “Sell Anything API”, and the “Sync API.”
For new integrations, we generally recommend starting out with the Sell Anything API as it enables you to build out your integration without needing to build a relationship with any merchants. The Sell Anything API works with every marketplace Rye supports, which makes it a reliable option. Down the line it is always possible to incrementally shift to the Sync API if you decide it’s a better fit for you and your business.
Below you can find a decision tree to help you determine which API is the best choice for your use case.
I only want to sell products from Amazon
I only want to sell products from Amazon
The Sell Anything API is the best choice as the Sync API does not work with Amazon products. See our guide for Connecting your Amazon Business account for more information on how to set up your Amazon Business account.
I only want to sell products from Shopify stores, and I don't have pre-existing merchant relationships
I only want to sell products from Shopify stores, and I don't have pre-existing merchant relationships
The Sell Anything API is the best choice as you can start building your integration immediately without third-party dependencies.
I only want to sell products from Shopify stores, and I am already working with merchants
I only want to sell products from Shopify stores, and I am already working with merchants
The Sync API is the best choice as it offers better data quality and additional features such as commissions.
I want to sell a mix of Amazon and Shopify products, and I have some merchant relationships
I want to sell a mix of Amazon and Shopify products, and I have some merchant relationships
In this case, you’ll want to use both APIs. The Sync API will be used for selling products from Shopify merchants you have a relationship with, and the Sell Anything API will be used for all other commerce. See our guide for Connecting your Amazon Business account for more information on how to set up your Amazon Business account.
Once you have chosen which API(s) your integration will use, you can move on to the next step where you’ll begin syncing over product data. Navigate to the appropriate guide by clicking on the API name below.