4.2 MSPI Catalog feed specification

The MSPI (Multiple Sellers per Item) Catalog Feeds are designed to accommodate e-commerce situations where catalog structure offers a many-to-many (n:m) relationship between sellers and items. This arrangement allows for a single item to be offered from multiple sellers. Consequently, an Item ID is not tied exclusively to a particular seller within the platform system and can be associated with multiple seller IDs.

Item catalog feed

Required fields

The following fields are required for each item in your catalog. If any required fields are missing or formatted incorrectly, items may not upload to your catalog and can be missing from your ads.

Field	Data Type	Note
id	String (up to 50 characters)	A unique identifier for the item Example: `039842`
title	String (up to 200 characters)	A specific, relevant title for the item Example: `Jordan`
image_link	String (up to 2,000 characters)	The URL of the main image of the item. It should begin with `https` and follow RFC 2396 or RFC 1738. Example: `https://www.molocostore.com/100/bag.png`
category	String (up to 150 characters)	Category of the product. Choose the most granular categories that describe the item. Use > as a delimiter among depths and use; as a delimiter among multiple categories. Include the full path of the categories. Example `Women>Clothing>T-shirts>V-neck` `Coffee and Tea;Bakery` `Men>Shoes>Athletic>Running;Men>Shoes>Athletic>Track & Field`

Recommended fields

The following fields are recommended to boost ad performance or filter out undesirable results.

Field	Data Type	Note
rating	Number (up to 4 characters)	The rating of the product. Use a scale of 5 or 10. Round it to one decimal place. Always use a period (.) as the decimal point. Example: `4.7`
review_count	Number (up to 20 characters)	The number of product reviews (purchase reviews) Example: `3850`
brand	String (up to 70 characters)	The brand name Example: `MOLOCO`
brand_id	String (up to 70 characters)	The brand ID Example: `Moloco` or `1AB234`
adult	String	Whether the item is not allowed for minors or contains adult content. It must be one of the following: `Y`, `N`
created_time	String (up to 25 characters)	Created time of the item information. The format should follow ISO 8601, such as the following: `YYYY-MM-DDThh:mm [+hhmm]` `YYYY-MM-DDThh:mmZ` Example: `2023-02-24T11:07+0100`
updated_time	String (up to 25 characters)	Last updated time of the item information. The format should follow ISO 8601, such as the following: `YYYY-MM-DDThh:mm [+hhmm]` `YYYY-MM-DDThh:mmZ` Example: `2023-02-24T11:07+0100`

Optional fields

You can also include many optional fields to share more item information with customers or control how items are displayed.

Field	Data Type	Note
location	String (up to 750 characters)	Locations where the product is eligible to sell. Provide the most specific product location possible from the list. Use `>` as a delimiter among depths. Use `;` as a delimiter among multiple locations. Include the exact locations. Include the full path of the location. Example: `CA>Redwoodcity;CA>Menlopark`, `Seoul>Gangnamgu>Yeoksamdong` If a value is absent in the Seller catalog, it will be taken from the Item catalog
shipping_charge	Number (up to 25 characters)	Shipping charge. Use the same format as the price field. Example `16.00` If a value is absent in the Seller catalog, it will be taken from the Item catalog
condition	String	The condition of the item. It must be one of the following: `new`, `used`, `refurbished` If a value is absent in the Seller catalog, it will be taken from the Item catalog
delivery_option	String (up to 200 characters)	The delivery option that is offered for the item. It must be one of the following: `one_day`, `same_day`, `regular`, `dawn` If a value is absent in the Seller catalog, it will be taken from the Item catalog
blocked	String (up to 50 characters)	Fill with any value if you need to block the item being advertised. Leave it empty if not. If a value is absent in the Seller catalog, it will be taken from the Item catalog
availability	String	The current availability of the item. It must be one of the following: `in_stock`, `out_of_stock`, `preorder`, `backorder` If a value is absent in the Seller catalog, it will be taken from the Item catalog
description	String (up to 5,000 characters)	A short, relevant description of the item. Example: Lightweight fabric and a relaxed cut. A comfortable jacket that slips on like a shirt.
link	String (up to 1,024 characters)	The link to your business’s website lets people learn more about or buy the item. It should start with `https`. It should formatted with RFC 2396 or RFC 1738. Example: `https://www.molocostore.com/products/100`
mobile_link	String (up to 1,024 characters)	The mobile link to your business’s website lets people learn more about or buy the item. It should start with `https`. It should formatted with RFC 2396 or RFC 1738. Example: `https://m.molocostore.com/products/100`
additional_image_link	String (up to 1,024 characters)	Additional image URL for the item. It should start with `https`. It should formatted with RFC 2396 or RFC 1738. Example: `https://www.molocostore.com/product/100/bag.png`
reward_point	String (up to 100 characters)	Enter if reward points are paid when purchasing a product Example: `naverpaypoint^500`
google_product_category	String (up to 750 characters)	Google product category. Example `Apparel & Accessories > Clothing > Outerwear > Coats & Jackets or 371`
item_group_id	String (up to 50 characters)	ID for a product group that comes in different versions (variants). Example: `1234AB`
color	String (up to 100 characters)	The main color of the item. Example: `Blue`
gender	String	The gender your item is targeted towards. It must be one of the following values: `unisex` `male` `female`
size	String (up to 100 characters)	The size of the item. Example: `XL`
material	String (up to 200 characters)	The material the item is made from. Example: `cotton` `polyester` `denim leather`
pattern	String (up to 100 characters)	The pattern or graphic print on the item Example: `Striped` `Floral`
age_group	String	The age group that the item is targeted towards. It must be one of the following: `all` `adult` `teen` `kids` `toddler` `infant` `newborn`
class (For Update Feed)	String	This field is only for the update feed. Enter whether the item is new, updated, or sold out. It must be one of the following: `N` - a new item. `U` - an item to be updated with the provided information. `D` - a deleted item. Only `id` and `class` fields are required.
is_bundle	String	Used if the item is sold in a bundle. It must be one of the following: `Y` `N`
gtin	String (up to 200 characters)	The Global Trade Item Number (GTIN) assigned by the manufacturer Example: `1234560012`
blocked	String (up to 50 characters)	Fill with any value if you need to block the item being advertised. Leave it empty if not.
custom_label_0	String (up to 200 characters)	Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: `Seasonal, Holiday, Black Friday`
custom_label_1	String (up to 200 characters)	Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: `Seasonal, Holiday, Black Friday`
custom_label_2	String (up to 200 characters)	Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: `Seasonal, Holiday, Black Friday`
custom_label_3	String (up to 200 characters)	Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: `Seasonal, Holiday, Black Friday`
custom_label_4	String (up to 200 characters)	Label that you assign to items to help organize bidding and reporting in sponsored ad campaigns. Example: `Seasonal, Holiday, Black Friday`

Seller catalog feed

Required fields

To establish a mapping relationship between an item and a seller in your catalog, the following fields must be provided. In case any of these mandatory fields are either absent or formatted incorrectly, it could result in the data not being uploaded in the mapping table, potentially leading to incorrect ad serving behavior.

Field	Data Type	Note
item_id	String (up to 50 characters)	A unique identifier for the item Example: `039842`
seller_id	String (up to 50 characters)	A unique seller/vendor ID. It is an Ad account ID for ad servicing & campaign management. Example: `38840029`
seller_title	String (up to 200 characters)	Name of seller/vendor. It is used as an Ad account title for ad servicing & campaign management. Example: `Moloco store`
price	Number (up to 25 characters)	The item's price that’s determined by the seller. Format the price as a number. Always use a period (.) as the decimal point, which supports up to two decimal places. For KRW and JPY, the value must be set as an integer, or the feed will not be processed. Example: `3.25` (for USD or EUR) `3000` (for KRW or JPY)
sale_price	Number (up to 25 characters)	Price after discounts. If the item is not discounted, set this equal to the ‘price’ value. Format the price as a number. Always use a period (.) as the decimal point, which supports up to two decimal places. For KRW and JPY, the value must be set as an integer or the feed will not be processed. Example: `3.25` (for USD or EUR) `3000` (for KRW or JPY)

Optional fields

You can also include many optional fields to share more item information with customers or control how seller’s items are displayed.

Field	Data Type	Note
location	String (up to 750 characters)	Locations where the product is eligible to sell. Provide the most specific product location possible from the list. Use `>` as a delimiter among depths. Use `;` as a delimiter among multiple locations. Include the exact locations. Include the full path of the location. Example: `CA>Redwoodcity;CA>Menlopark` `Seoul>Gangnamgu>Yeoksamdong` If a value is absent in the Seller catalog, it will be taken from the Item catalog.
shipping_charge	Number (up to 25 characters)	Shipping charge. Use the same format as the price field. Example `16.00` If a value is absent in the Seller catalog, it will be taken from the Item catalog
condition	String	The condition of the item. It must be one of the following: `new` `used` `refurbished` If a value is absent in the Seller catalog, it will be taken from the Item catalog
delivery_option	String (up to 200 characters)	The delivery option that is offered for the item. It must be one of the following: `one_day` `same_day` `regular` `dawn` If a value is absent in the Seller catalog, it will be taken from the Item catalog
blocked	String (up to 50 characters)	Fill with any value if you need to block the item being advertised. Leave it empty if not. If a value is absent in the Seller catalog, it will be taken from the Item catalog
availability	String	The current availability of the item. It must be one of the following: `in_stock` `out_of_stock` `preorder` `backorder` If a value is absent in the Seller catalog, it will be taken from the Item catalog