Get Feed
GET/products/feed
Retrieves products feed. The endpoint can return variable products containing it's variants and simple products.
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
- variable
- simple
Array [
]
Array [
Array [
]
]
]
products
object[]
oneOf
Product's unique identifier
Available stock or -1 when backorders are allowed
Indicates whether product is physical or virtual
variations
object[]
required
Product's unique identifier
Available stock or -1 when backorders are allowed
Indicates whether product is physical or virtual
attributes
object
required
Product attributes are the characteristics, such as color, size etc. that define a variation product or provide configuration information about a simple product. attributes object holds a list of attribute id/attribute value id pairs applied on this product. So for the following attribute applied on the product, {attribute_id => 1, attribute_label => color, attribute_option_label => black, attribute_option_id => 34}, this is expected as response: {'1':'34'}. These attributes are used during quote and order.
options
object[]
required
Attribute's unique identifier e.g attr_color
Attribute's user friendly title e.g Color
values
object[]
required
A list of possible values for this option
Value's unique identifier e.g. val_black
Value's user friendly title e.g Black
Product's unique identifier
Available stock or -1 when backorders are allowed
Indicates whether product is physical or virtual
attributes
object
Product attributes are the characteristics, such as color, size etc. that define a variation product or provide configuration information about a simple product. attributes object holds a list of attribute id/attribute value id pairs applied on this product. So for the following attribute applied on the product, {attribute_id => 1, attribute_label => color, attribute_option_label => black, attribute_option_id => 34}, this is expected as response: {'1':'34'}. These attributes are used during quote and order.
titled_attributes
object
Product attributes are the characteristics, such as color, size etc. that define a variation product or provide configuration information about a simple product. titled attributes object holds a list of attribute id title/attribute value title pairs applied on this product. So for the following attribute applied on the product, {attribute_id => 1, attribute_label => color, attribute_option_label => black, attribute_option_id => 34}, this is expected as response: {'color':'black'}. The titled attributes are only used in product display in UI and not in any subsequent api calls.
{
"products": [
null,
null
]
}
{
"products": [
{
"id": "123456",
"sku": "product-id-2",
"title": "Product 2",
"description": "Product 2 description",
"image_url": "https://www.mystore/com/assets/img/product-2.jpg",
"stock": 3,
"price_cents": 2000,
"shippable": true,
"category": "Category",
"url": "https://www.mystore/com/products/product-id-2",
"options": [
{
"id": "attr_color",
"title": "Color",
"values": [
{
"id": "val_black",
"title": "Black"
},
{
"id": "val_white",
"title": "White"
}
]
},
{
"id": "attr_size",
"title": "Size",
"values": [
{
"id": "val_s",
"title": "S"
},
{
"id": "val_m",
"title": "M"
}
]
}
],
"variations": [
{
"id": "1234567",
"sku": "product-id-2-1",
"title": "Product 2-1",
"stock": 2,
"description": "Product 2-1 description",
"image_url": "https://www.mystore/com/assets/img/product-2-1.jpg",
"price_cents": 2200,
"shippable": true,
"attributes": {
"attr_size": "val_s",
"attr_color": "val_black"
}
},
{
"id": "12345678",
"sku": "product-id-2-2",
"title": "Product 2-2",
"stock": 3,
"description": "Product 2-2 description",
"image_url": "https://www.mystore/com/assets/img/product-2-2.jpg",
"price_cents": 2300,
"shippable": true,
"attributes": {
"attr_size": "val_m",
"attr_color": "val_black"
}
},
{
"id": "123456789",
"sku": "product-id-2-3",
"title": "Product 2-3",
"stock": 0,
"description": "Product 2-3 description",
"image_url": "https://www.mystore/com/assets/img/product-2-3.jpg",
"price_cents": 2200,
"shippable": true,
"attributes": {
"attr_size": "val_s",
"attr_color": "val_white"
}
},
{
"id": "1234567890",
"sku": "product-id-2-4",
"title": "Product 2-4",
"stock": 0,
"description": "Product 2-4 description",
"image_url": "https://www.mystore/com/assets/img/product-2-4.jpg",
"price_cents": 2350,
"shippable": true,
"attributes": {
"attr_size": "val_m",
"attr_color": "val_white"
}
}
]
}
]
}