Skip to main content
Use the SDK discovery APIs to fetch trending and recommended community lists. These methods call the social.plus backend discovery endpoints and return community collections or lists, depending on platform.

Trending Communities

Fetch communities from the trending endpoint

Recommended Communities

Fetch communities from the recommended endpoint
The ranking logic is owned by the backend service. The client SDK exposes methods to request and render the returned communities.

Parameters

The getTrendingCommunities() method fetches communities from the trending endpoint. TypeScript exposes a Live Collection with pagination options, iOS exposes a Live Collection, Android returns a Flowable<List<AmityCommunity>>, and Flutter returns a Future<List<AmityCommunity>>.
The getRecommendedCommunities() method fetches communities from the recommended endpoint. Use it when your discovery UI needs a backend-curated list instead of a filter-based query.

Best Practices

Recommendation Refresh: Refresh trending and recommended communities intentionally, such as when the user opens the discovery surface or pulls to refresh.

User Experience Guidelines

  1. Loading States: Show skeleton screens during discovery data fetching
  2. Empty States: Provide fallback content when no recommendations are available
  3. Action Feedback: Give immediate feedback when users join discovered communities

Performance Optimization

  1. Pagination: Use TypeScript pagination options when building longer discovery feeds
  2. Image Optimization: Preload community avatars for smooth scrolling
  3. Background Updates: Refresh discovery data in the background

Query Communities

Advanced community search and filtering capabilities

Join Community

Implement community membership actions from discovery

Community Categories

Learn about community organization for better recommendations

Get Community Details

Display detailed community information before joining