Recommendations data source

Use the Recommendations data source type to return For you (viewer-specific) or Trending (global) feeds. It's available for Moments and Stories.

Pick one type per data source. For you and Trending are separate feeds: For you ranks content for the individual viewer, and Trending returns a shared feed ranked by overall engagement. The type you pick determines which feed the SDK requests.

For how Trending, explicit personalization, and implicit For you fit together in Concepts, see Content recommendations.

To put another data source (for example, Labels) ahead of Trending or For you in one feed, use Composite data source.

Platform API reference

For you and Trending types: BlazeRecommendationsType (iOS) · BlazeRecommendationsType (Android)
Data source type (all platforms): BlazeDataSourceType (iOS) · BlazeDataSourceType (Android) · DataSourceBuilder on the BlazeSDK class (Web)
Optional ID and label filtering on Recommendations: BlazeDataSourcePersonalizedType (iOS) · BlazeDataSourcePersonalizedType (Android). On Web, use optional personalized on labels in DataSourceBuilder.

Recommendation types

Type	Description
`forYou`	Viewer-specific recommendations (personalized)
`trending`	Global content across the platform

Parameters

Parameter	Type	Mandatory	Description
`anyLabelFilter`	array of strings	no	Filters recommended content by these labels
`coldStartLabels`	array of strings	no	Filters cold start content by these labels, for For you only

The coldStartLabels parameter applies to the For you recommendation type only, not Trending. See Cold start for For you.

Personalized filtering options

Method	Type	Mandatory	Requirements
`ids`	array of strings	yes	Requires one or more entity keys, for example, `players` and `teams`, to filter by content type
`labels`	string / object	yes	Requires `labelExpression`. Can optionally include `labelsFilter` and `labelsPriority`

See Ordering and item limits for item count settings.