Selecting products and APIs
Selecting products to sell
The first step to building out your gifting 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.
Determine which API(s) you will need
Rye offers two different APIs depending on your use case: the Sell Anything API, and the Sync API. If some of the stores you want to sell products from are running on Shopify and you have a pre-existing relationship with them, then the Sync API is the best choice. For all other situations the Sell Anything API is the best choice, offering the ability to sell products from both Amazon and Shopify stores without any kind of merchant relationship.
Rye’s Amazon products integration currently only covers Amazon Canada & US. If your use case requires products from other Amazon regions, please contact us so we can prioritize adding support for the regions you require.
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. Once your integration is up an running, you can incrementally shift to the Sync API as you onboard merchants.
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 to Amazon Business 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 to Amazon Business 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.