Skip to main content

Personalization API

The Tidal Personalization API is designed to enhance user experience by providing intelligent and personalized product recommendations. This enhances the user experience by leveraging advanced data analysis and machine learning techniques, it ensures users receive the most relevant product suggestions.

If you have any questions or need further assistance, please contact your customer success manager.

Key Features​

Personalized Recommendations​

Personalized Recommendations leverages advanced machine learning algorithms to analyze user behavior and interaction patterns. By examining the purchasing habits and preferences of users with similar profiles, the service can identify and suggest products that are most likely to be of interest to a specific user. This feature helps to create a more engaging and relevant shopping experience, encouraging users to explore and purchase items that align with their tastes.

  • Enhanced User Experience: Tailors the shopping experience to individual preferences, making it more enjoyable and efficient.
  • Increased Engagement: By presenting users with products they are more likely to be interested in, it boosts interaction and time spent on the platform.
  • Improved Conversion Rates: Personalized recommendations can lead to higher conversion rates as users are more likely to purchase items that match their preferences.

Top Products​

Top Products provides insights into the most frequently purchased products at a given retail location. This feature helps to highlight popular and trending items, making it easier for users to find products that are currently in high demand. By showcasing these top products, retailers can drive higher sales and enhance the shopping experience by promoting items that have proven to be favorites among the customer base.

  • Popular Product Discovery: Helps users quickly find and purchase the most popular items.
  • Trend Identification: Allows retailers to identify and capitalize on current market trends.
  • Sales Boost: Promoting top products can lead to increased sales and customer satisfaction.

Past Purchases​

Past Purchases provides users with a comprehensive list of items they have previously bought. This feature is particularly useful for users who want to reorder products or track their shopping history. By making past purchase information easily accessible, it enhances the convenience and efficiency of the shopping experience, encouraging repeat purchases and fostering customer loyalty.

  • Easy Reordering: Simplifies the process for users to repurchase items they have bought before.
  • Purchase History Tracking: Allows users to keep track of their past purchases and manage their shopping habits.
  • Customer Loyalty: By providing a convenient way to access past purchases, it encourages repeat business and strengthens customer relationships.

Prerequisites and Examples​

Before using the Tidal Recommendation Service, ensure that you have:

  • Access to the Tidal API.
  • Valid locationId and userId or productId for making userId or productId recommendations.

Get Personalized Recommendations​

  • Description: This feature provides personalized product suggestions to users based on the interaction patterns of similar users.

  • URL: /r/for-you

  • Method: GET

  • Query Parameters:

    • accountId (string): The account ID.
    • siteId (string): The site ID.
    • locationId (string): The location ID.
    • userId (string): The user ID. (if the user is logged in)

  • Example:

    curl "https://t.surfside.io/r/for-you?accountId=123&siteId=456&locationId=789&userId=101"

Get Top Products​

  • Description: Fetches the top products for the specified account, site, and location.

  • URL: /r/top-products

  • Method: GET

  • Query Parameters:

    • accountId (string): The account ID.
    • siteId (string): The site ID.
    • locationId (string): The location ID.

  • Example:

    curl "https://t.surfside.io/r/top-products?accountId=123&siteId=456&locationId=789"

Get Buy-Again Recommendations​

  • Description: Fetches buy-again recommendations for the user.

  • URL: /r/buy-again

  • Method: GET

  • Query Parameters:

    • accountId (string): The account ID.
    • siteId (string): The site ID.
    • locationId (string): The location ID.
    • userId (string): The user ID.

  • Example:

    curl "https://t.surfside.io/r/buy-again?accountId=123&siteId=456&locationId=789&userId=101"