API Reference

Changelog

Rye Console

Get Started

Rye's API allows you to fetch product inventory for items from the largest retailers in the United States and Global Shopify Stores. However, only Amazon US and Shopify stores are supported for the time being.

About Rye

Definitions

Get your API key and send your first Rye API request!

Quick start

It is important to have certain HTTP headers as part of your Rye API requests.

HTTP Headers

Retrieve a Product by its ID. This includes some basic fields like title, and description. This is useful for displaying products on screens where you need to display products across marketplaces together. But, each product marketplace offers extra metadata and in order to expose that to developers, Rye uses GraphQL inline fragments to expose high-fidelity information about each item.

productByID

Returns an array of Products filtered by a given store domain. This query can be used for paging through a set of products from a domain from Shopify.

productsByDomainV2

Retrieve a Cart by its ID. This query can be used to retrieve information about an existing cart.

getCart

Returns a Checkout object by cart ID. This query can be used to retrieve information about the checkout status for an already submitted cart as well as order details for all orders associated with the checkout

checkoutByCartID

Returns an Order object by ID. This query can be used to retrieve information about the individual order.

orderById

Returns information about the Rye's Shopify App.

shopifyApp

Returns environment token used by RyePay.

environmentToken

Requests a product to be tracked by Rye's API. Products will be refreshed on some interval. A product must be requested before it can be queried.

requestProductByURL

Requests a store to be tracked by Rye's API.

requestStoreByURL

Adds new items to an existing shopping cart. This mutation resets selected shipping method of updated stores, and user will need to select shipping method again

addCartItems

cancelOrder

Creates a new shopping cart with the specified items from Amazon and/or Shopify stores. Allows users to add products (for Amazon) or product variants (for Shopify) along with their quantities to a new cart.

createCart

Deletes items from an existing shopping cart. This mutation resets selected shipping method of updated stores, and user will need to select shipping method again. If a cart becomes empty our API won't delete the cart itself. You can continue using it to add more items as needed.

deleteCartItems

Removes an existing shopping cart based on the provided cart ID. It allows users to remove a cart that is no longer needed or relevant.

removeCart

submitCart

Updates the quantity of existing products in a cart. This mutation resets selected shipping method of updated stores, and user will need to select shipping method again

updateCartItems

Updates the buyer's identity if it was not provided in the createCart mutation.

updateCartBuyerIdentity

Updates shipping methods for stores in the cart

updateCartSelectedShippingOptions

proposeShopifyMerchantCommission

The input fields to represent the information required to fetch a product by its ID.

ProductByIDInput

The input fields to represent the information required to fetch products by a store's domain.

ProductsByDomainInput

The input fields to represent the information required to fetch products by a vendor.

ProductsByVendorInput

The input fields to represent the information required to fetch a store by its URL.

RequestStoreByURLInput

The input fields to represent the information required to fetch a product by its URL.

RequestProductByURLInput

The input fields to represent pagination information

OffsetPaginationInput

The input fields to provide the necessary information to add or update Amazon products in the cart. It is included as a part of the CartItemsInput object, which allows the API to handle items from multiple platforms, including Amazon.

AmazonCartItemsInput

The input fields to specify a single Amazon product to be removed from the cart.

AmazonProductIDInput

BillingAddressInput

The input fields to provide or update the buyer's identity and contact information. By supplying this information, the API can ensure accurate billing and shipping information for the buyer's order and facilitate personalized communication and support.

BuyerIdentityInput

The input fields to provide the necessary information to submit a cart for processing through the submitCart mutation. By providing the cart ID, tokenized payment information, and billing address, the API can process the payment and complete the purchase. Once the cart is submitted, the user's payment is processed, and the purchased items are prepared for shipping or digital delivery, as applicable.

CancelOrderInput

The input fields to provide the necessary information to update the buyer identity associated with a cart through the `updateCartBuyerIdentity` mutation. By providing the cart ID and the updated buyer identity information, the API can update the cart's buyer identity accordingly.

CartBuyerIdentityUpdateInput

CartCreateInput

The input fields to provide the necessary information to remove a cart through the `removeCart` mutation. By providing the cart ID, the API can identify and delete the specified cart.

CartDeleteInput

The input fields to provide the necessary information to add new items to a cart through the `addCartItems` mutation. By providing the cart ID and the list of items to be added, the API can update the cart with the new items.

CartItemsAddInput

The input fields to provide the necessary information to remove items from a cart through the `deleteCartItems` mutation. By providing the cart ID and the list of items to be removed, the API can update the cart by removing the specified items.

CartItemsDeleteInput

The input fields to gather and organize the items a buyer wants to add or update in their cart, taking into account the specific platform the products are from (Amazon or Shopify). By including both Amazon and Shopify items, this input object allows the Rye's Sell Anything API to handle products from different platforms within a single cart, enabling a more seamless and integrated shopping experience for the user.

CartItemsInput

The input fields to provide the necessary information to update the items in a cart through the `updateCartItems` mutation. By providing the cart ID and the updated list of items, the API can modify the cart according to the user's preferences.

CartItemsUpdateInput

CartSubmitInput

The input fields to provide information about promo codes applied to stores in the cart

StorePromoCodesInput

The input fields to specify the products that need to be removed from the cart.

DeleteCartLinesInput

The input fields to provide the necessary information to add or update Shopify product variants in the cart. It is included as a part of the CartItemsInput object, which allows the API to handle items from multiple platforms, including Shopify.

ShopifyCartItemsInput

The input fields to specify a single Shopify product variant to be removed from the cart.

ShopifyVariantIDInput

The input fields to provide the necessary information to update a shipping method associated with a specific store

UpdateCartSelectedShippingOptionsInput

Input type for proposing a new merchant commission rate for a Shopify store.

ProposeShopifyMerchantCommissionInput

Represents a product category for an Amazon item. These categories can change over time.

AmazonCategory

Represents an image for an Amazon product.

AmazonImage

Represents products from the Amazon marketplace. It includes details such as the product's title, description, price, availability, images, and other attributes. These details help the API to handle products from Amazon in a way that's consistent with products from other sources, like Shopify, and to provide users with a seamless shopping experience across different platforms.

AmazonProduct

Represents product protection plans offered by the seller or manufacturer on Amazon. These protection plans can provide additional coverage, such as an extended warranty or accidental damage protection, for products purchased on Amazon.

AmazonProtectionPlan

Represents a product specification for an Amazon item. These specifications provide more detailed information about the product.

AmazonSpecification

Represents a secondary title usually displayed below the main title of a product on Amazon.

AmazonSubtitle

Represents a variant of an Amazon product, which typically includes different colors or dimensions.

AmazonVariant

Represents a dimension of an Amazon product variant.

AmazonVariantDimension

Represents a video describing an Amazon product.

AmazonVideo

Represents an option for customizing a product.

ProductOption

Represents a response of requestProductByURL mutation

RequestProductResponse

Represents a response of requestStoreByURL mutation

RequestStoreResponse

Represents an image for a Shopify product.

ShopifyImage

Represents an image for a Shopify product in the form of a URL only.

ShopifyImageURL

Represents products from the Shopify stores. It includes details such as the product's title, description, price, availability, images, and other attributes. These details help the API to handle products from Shopify in a way that's consistent with products from other sources, like Amazon, and to provide users with a seamless shopping experience across different platforms.

ShopifyProduct

Represents a product review for a Shopify product.

ShopifyProductReview

Represents an edge in the ShopifyProductReviewsConnection.

ShopifyProductReviewEdge

Represents a paginated connection of Shopify product reviews.

ShopifyProductReviewsConnection

The ShopifyVariant type allows Rye's Sell Anything API to manage and display information about specific variants of Shopify products, such as their availability, pricing, and custom options.

ShopifyVariant

Represents cart items from an Amazon store. Allows updating the quantity of each item and providing detailed information about each product.

AmazonCartLine

Represents various price-related information and shipping methods for the products in the cart.

AmazonOffer

AmazonStore

Represents the buyer's information within the API schema. It enables the system to accurately process orders, calculate shipping costs, handle taxes, and communicate with the buyer as needed throughout the purchasing process. This object ensures a smooth and efficient experience for both the buyer and the seller.

BuyerIdentity

Represents a shopping cart that contains items from one or more stores, such as Amazon or Shopify. It is used to manage the shopping experience, track selected items, and store buyer information.

Cart

Represents estimated costs that the buyer will pay at checkout. The costs are subject to change and changes will be reflected at checkout. The cost field uses the buyerIdentity field to determine shipping pricing

CartCost

Represents a shopping cart which is a result of queries or mutations, along with any possible errors that occurred during operations.

CartResponse

Represents information related to the checkout process of a user's order submission, which includes details such as the user's shipping address, payment method, and any applicable discounts or promotions.

Checkout

Represents a deleted cart containing the ID of the deleted cart.

DeletedCart

Response after cancelOrder mutation is called.

CancelOrderResponse

Represents an order that a customer places for a product.

Order

Result type for canceling a Shopify order

CancelShopifyOrderResult

Represents the response after canceling an Amazon order

CancelAmazonOrderResult

CancelAmazonOrderItem

Represents a failed payment status for an order.

OrderCancelFailedOrderEvent

Represents a successful payment status for an order.

OrderCancelStartedOrderEvent

ReturnApprovedEvent

ReturnClosedEvent

AmazonReturnRequestedEventData

AmazonReturnLineItem

ShopifyReturnLineItem

ShopifyReturnRequestedEventData

AmazonReturnApprovedEventData

ShopifyReturnApprovedEventData

AmazonReturnClosedEventData

ShopifyReturnClosedEventData

OrderCancelSucceededOrderEvent

OrderFailedOrderEvent

OrderPlacedOrderEvent

Represents a submission started status for an order.

OrderSubmissionStartedOrderEvent

Represents a submission succeeded status for an order.

OrderSubmissionSucceededOrderEvent

PaymentFailedOrderEvent

Represents a refunded payment status for an order.

PaymentRefundedOrderEvent

PaymentSucceededOrderEvent

Represents shipping option selected for a store.

SelectedShippingOption

ShippingMethod

Represents cart items from a Shopify store. Allows updating the quantity of each item and providing detailed information about each product variant.

ShopifyCartLine

ShopifyOffer

ShopifyStore

Represents the result of submitting a cart.

SubmitCartData

SubmitCartResult

Represents the result of submitting a store within a cart.

SubmitStoreResult

Represents a tracking obtained status for an order.

TrackingObtainedOrderEvent

Serves as a gateway for accessing features and functionalities related to Rye's Shopify App.

ShopifyApp

Represents the installation link for Rye's Shopify App specific to a given Shopify store.

ShopifyAppInstallationLink

Contains the evnironment token for RyePay.

Start Here

Solutions & Guides

Sell Anything API

Monetization API

Environment

About Rye

How Rye works

Use case