​
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 URLStore URL
https://www.allbirds.com/products/womens-tree-runnershttps://www.allbirds.com/
https://kith.com/products/khm031515-413https://kith.com/
https://kith.com/products/khm031517-302https://kith.com/
Once you have compiled this list of products you are ready to move on to the next step.

​
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.
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.

Use the Sell Anything API

For Amazon products, and Shopify products from merchants you don’t have a relationship with.

Use the Sync API

For Shopify products from merchants you have a relationship with.