/landing-page-recs

This page details the request and response formats for Frenzy Search’s Landing Recommendations endpoint, along with examples to make implementation easier.

The endpoint returns products intended for use on various landing pages—such as the homepage, zero-results pages, 404 pages, and more.

Note: The /landing-page-recs endpoint combines the capabilities of both /most-clicked-skus and /personalized-recommendation. We recommend using /landing-page-recs going forward to take advantage of the latest features.

Landing Page Recommendations

POST https://xyz.search.frenzy.ai/landing-page-recs

Query Parameters

Name	Type	Description
full_description	boolean	To get all products with their attributes set it to true. (Default false)
num_matching	integer	Required number of matching products
user_id	string	User id associated with the request (only required for personalization).
session_id	string	Session id associated with the request.
config_id	string	Configuration id for widget..
shop	string	Shopify's myshopify url. (without https://)
ab_test_id	string	A/B test id when test is running.
currency	string	Currency code.
country	string	Country code.
state	string	State code.
company_id	string	Shopify B2B company id.
location_id	string	Shopify B2B location id.
publication_app_id	string	Shopify publication app id.

Headers

Name	Type	Description
X-Frenzy-Authorization*	string	API key provided at the time of account creation.
X-Shop	string	Shopify's myshopify url. (without https://)

200 Top N matching products for the given product-id are successfully retrieved.

Success

{  // list of matching products
  "matching_products": [
    "PSS-001-00001",
    "PSS-002-00002",
    ....
    ...
    ...
    "PSS-010-00015"
  ]
}

Success(full_description=true)

Failure

NOTE: For Shopify Customers

1. num_matching = is set in the portal

Response Object

Key	Type	Value
matching_products	array	Top N matching products
request_id	string	Id to track the request