Recommendation pages

Retrieve recommendation page

๐Ÿ” This endpoint requires HTTP authentication (either Basic or Bearer). For authenticating with Bearer token, required scopes are: recommendations(r).

Beta: This endpoint is in beta and may change. It is currently available to a small group of users. To request access, contact your Customer Success Manager.

Return the page configured under page_id for the selected key and section. Answers 404 if there is none.

get/v1/recommendation_pages/{page_id}

Request

  • Base URL
    https://ac.cnstrc.com
  • URL
    https://ac.cnstrc.com/v1/recommendation_pages/{page_id}
  • Auth
    • HTTP basic
    • or HTTP bearer

Path parameters

page_idstring required

Query parameters

keystring required

The key of the index to use.

Example:key_K2pX7vBnU0bgA5xp
sectionstring

The section of the index to use. Defaults to Products.

Example:Products
cstring

The ID of the client and version that the request is coming from, such as cio-js-2.90.

Example:cio-js-2.90

Response

OK

page_idstring required

The unique identifier of the page within the key and section: a lowercase slug of letters, digits, underscores and hyphens, starting with a letter or digit, at most 255 characters. Surrounding whitespace is stripped.

display_namestring required

The name of the page displayed to merchandisers, between 2 and 100 characters. Surrounding whitespace is stripped.

page_type'pdp' | 'plp' | 'home' | 'cart' | 'atc' | 'checkout' | 'order_confirm' | 'empty_cart' | 'other' required
created_atstring date-time required

The date and time the page was created.

updated_atstring date-time required

The date and time the page was last updated.

Example response

{
  "page_id": "pdp_b2c",
  "display_name": "PDP - B2C",
  "pods": [
    {
      "pod_id": "similar_items"
    }
  ],
  "created_at": "2021-01-01T00:00:00",
  "updated_at": "2021-02-01T00:00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.