---
title: "Recommend Next Item Segments"
method: POST
path: "/{databaseId}/recomms/next/item-segments/{recommId}"
tags: ["Recommendations"]
---

# Recommend Next Item Segments

`POST /{databaseId}/recomms/next/item-segments/{recommId}`

Returns [Item Segments](https://docs.recombee.com/segmentations) to be shown as the next recommendations when a user scrolls (e.g., within a carousel or feed of Item Segments such as brands, artists, topics, or categories).

The request requires the `recommId` of a base recommendation request and the number of Segments to return (`count`).

The base request can be one of:
  - [Recommend Item Segments to Item](https://docs.recombee.com/api#recommend-item-segments-to-item)
  - [Recommend Item Segments to User](https://docs.recombee.com/api#recommend-item-segments-to-user)
  - [Recommend Item Segments to Item Segment](https://docs.recombee.com/api#recommend-item-segments-to-item-segment)
  - [Search Item Segments](https://docs.recombee.com/api#search-item-segments)

All other parameters are inherited from the base request associated with the provided `recommId`.

This endpoint can be called multiple times for a single `recommId`. Each call returns different Item Segments that have not been recommended in previous calls.
The number of calls made so far is returned in the `numberNextRecommsCalls` field.

Requests can be made up to 30 minutes after the base request or the most recent Recommend Next Item Segments call.

For billing purposes, each call to this endpoint is counted as a separate recommendation request.

## Path parameters

- `databaseId` string, required
- `recommId` string, required

## Request body

- RecommendNextItemSegmentsParameters
  - `count` integer, required — Number of item segments to be recommended

## Response `200`

Successful operation.

- RecommendationResponse
  - `recommId` string, required — Id of the recommendation request
  - `recomms` Recommendation[], required — Obtained recommendations
    - `id` string, required — Id of the recommended item
    - `values` object — Property values of the recommended item
    - `reqlEvaluations` object — Dictionary of evaluated ReQL expressions specified in the request and calculated for the recommended item. The keys are the names of the ReQL expressions, and the values are the results of the evaluations.
  - `numberNextRecommsCalls` integer — How many times *Recommend Next Items* have been called for this `recommId`
  - `abGroup` string — Name of AB-testing group to which the request belongs if there is a custom AB-testing running.

## Other responses

- `400` — Parameter `count` is not given or is not a positive integer. Parameter `recommId` is not an UUID.
- `404` — Base request with the given `recommId` does not exist or has expired.

---

[API](https://skmtc.dev/recombee/apis/recombee-api.md) · [All operations](https://skmtc.dev/recombee/apis/recombee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recombee/recombee-api/revisions/a9c9c33eb2e8/schema)