New Arrivals

The New Arrivals algorithm displays products that have been newly added to the website. It directly accesses the catalog and sorts products by creation date. Changing the integration type doesn't affect the results if the product is already in the database. You can use the New Arrivals algorithm on the main page to showcase new products.

For the Publisher vertical, the updated time applies to newly released articles.

Endpoint

GET https://recommendation.api.useinsider.com/v2/new-arrivals

Visit our Postman collection to test this request.

Query Parameters

Parameter	Sample Value	Description	Data Type	Required
partnerName	mybrand	Partner Identifier assigned by Insider One. You can use PartnerID as well.	String	Yes
locale	us_US	Locale of requested product catalog	String	Yes
platform	web	Requested platform. Web comes by default.	Enum	No
currency	USD	Requested currency of the products. If no value is set, the default currency in your settings is used.	String	No
size	50	Required number of items in response. Valid values are 0 to 100.	Integer	No
categoryList	[“Clothes”, “Skirts”]	Category filter of the products	Array (of string)	No
filter		Smart Recommender filtering. There can be more than one filter parameter.	String	No
details	true	Adds details to the products of the response	Boolean	No
shuffle	false	Shuffles the products of the response	Boolean	No
getGroupProducts	false	Shows variant products under the products of the response	Boolean	No
groupProductsFields		Adds these fields to the variant products’ details	String	No
excludeVariants	true	Exclude variants from the response	Boolean	No
userId	testUser	User ID	String	No
hp	true, false or 0, 1	Makes affinities affect products of the response. The default is false.	Boolean	No
excludeViewDay	30	After how many days viewed products should be excluded	Integer	No (Can only be used with userId)
excludeViewItem	10	How many viewed products should be excluded. The default is -1.	Integer	No (Can only be used with userId)
excludePurchaseDay	30	After how many days purchased products should be excluded. The default is -1.	Integer	No (Can only be used with userId)
excludePurchaseItem	10	How many purchased products should be excluded. The default is -1.	Integer	No (Can only be used with userId)
productId	ABC123CBA	Current product ID	String	No

Algorithm Customization

The New Arrivals algorithm can also provide users with discounted product recommendations within the desired category.

Variant Name	Condition	Parameter(s)
New Arrivals of Partner	No category filter	Default (no categoryList)
New Arrivals of Category	Category filter provided	categoryList=[cat1, cat2, ...]

When categoryList is provided, only newly added products within the specified categories are recommended, ordered by publish date. Recommendations served in the API response will be abbreviated as naoc for the New Arrivals of Category recommendations.

Sample Request

The sample below displays a request to New Arrivals, an algorithm that recommends products newly added to the website.

https://recommendation.api.useinsider.com/v2/new-arrivals?locale={Locale}&partnerName={PartnerName}

Sample Response

{
        "success": true,
        "total": 1,
        "types": {
        "naop": 1
        },
        "data": [
        {
        "image_url": "test.image_url.com",
        "name": "Original Air-dried Beef recipe for dogs",
        "item_id": "46177313784082",
        "url": "test.url.com",
        "description": "Having access to lush fields of grass year-round makes New Zealand free-range, grass-fed beef among the best in the world.",
        "in_stock": 1,
        "price": {
        "USD": 29.58
        },
        "groupcode": "8528988209426",
        "locale": "en_US",
        "product_attributes": {
        "activation_date": "2023-08-11",
        "shopify_tag": [
        "air-dried",
        "beef",
        "dog"
        ]
        },
        "stock_count": 99,
        "category": [
        "Dog Food",
        "Pets Collection"
        ],
        "discount": {
        "USD": 0.0
        },
        "original_price": {
        "USD": 29.58
        }
        }
        ]
        }

Sample Request for New Arrivals of Category

https://recommendation.api.useinsider.com/v2/new-arrivals?locale={Locale}&partnerName={PartnerName}&currency={Currency}&categoryList=[“Dog Food”]

Sample Response

{
        "success": true,
        "total": 1,
        "types": {
        "naoc": 1
        },
        "data": [
        {
        "image_url": "test.image_url.com",
        "name": "Original Air-dried Beef recipe for dogs",
        "item_id": "46177313784082",
        "url": "test.url.com",
        "description": "Having access to lush fields of grass year-round makes New Zealand free-range, grass-fed beef among the best in the world.",
        "in_stock": 1,
        "price": {
        "USD": 29.58
        },
        "groupcode": "8528988209426",
        "locale": "en_US",
        "product_attributes": {
        "activation_date": "2023-08-11",
        "shopify_tag": [
        "air-dried",
        "beef",
        "dog"
        ]
        },
        "stock_count": 99,
        "category": [
        "Dog Food",
        "Pets Collection"
        ],
        "discount": {
        "USD": 0.0
        },
        "original_price": {
        "USD": 29.58
        }
        }
        ]
        }

Fallback Algorithms

If the products from New Arrivals are not enough to fill the response data, some fallback algorithms below fill it:

New arrivals of the category, including the rightmost item in the categoryList.