QUICKSTART
API Quick Start
Authentication
SignString
Versioning
Rate Limit
Body Envelope
Request Errors
CHANGELOG
Changelog
Scenarios
Recommendations
Best Sellers
Bought Together
Complements
New Arrival
Random
Similar
Search
Semantic Search
Visual Search
Browse
Tagging
Product tagging
Reference
API Overview
Discoveries
Recommend products
post
Suggest product query
post
Search products
post
Predict product category and tags
post
Model
Envelope
Meta
v1
Error
v1
Pagination
v1
Primitive
Partial Product
Predict Tag
Predict Category
Tagging Product
ENUM
Filter key
Support
Contact Support

Overview

This document focuses on the New Arrival API within the recommendation module. This API is designed to spotlight the latest products added to the platform's catalog, offering customers an easy way to discover and explore the newest items available. By featuring new arrivals across various categories, the API aids in promoting the latest trends, innovations, and selections, encouraging customer engagement and driving interest in new product lines.

Use Case

Imagine a fashion enthusiast exploring an online clothing retailer looking for the latest styles for the upcoming season. With the New Arrival API, the platform can showcase a curated selection of the newest additions in apparel, ranging from designer collaborations to seasonal collections. This feature ensures that customers are immediately aware of the latest offerings, helping them stay ahead of fashion trends and making the platform a go-to destination for new and trendy products.

Feature Comparison

Compare to other Personalization API features:

  • Bought Together and Complements
    While the Bought Together and Complements focus on recommending products based on historical purchase data and product compatibility, respectively, the New Arrival specifically highlights the most recently added products to the catalog, regardless of their purchase history or compatibility with other items.

  • Similar
    The Similar provides recommendations based on similarity to a product being viewed, focusing on features, design, or the category. In contrast, the New Arrival showcases products solely based on their newness to the platform.

  • Random
    Random offers a random selection of items across the platform, the New Arrival intentionally features the latest products, providing a targeted approach to discovering new items.

Example

The below sample request demonstrates how to retrieve new arrival recommendations by specifying the NEW_ARRIVAL type. It includes the session ID for tracking the user's session and sets the limit to 5, indicating that a maximum of 5 recommended products should be returned in the response. The request body should contain the following parameters:

  • type: Set this to NEW_ARRIVAL to specify the type of recommendation as new arrivals.

  • session_id: Represents the unique identifier for the user session.

  • limit: Determines the maximum number of products to be returned in the response. In this example, the limit is set to 5.

Sample Request

preparing...

By making this request, the API will analyze the catalog and provide a list of newly added products, allowing the platform to showcase the latest additions to its customers.

Sample Response

preparing...