Search & Browse

• Search — full-text query across the catalog.
• Browse — curated editorial entry points (featured, new releases, charts, genres).

​

Search

const res = await discovery.search({
  q: "Fairouz",
  types: [ContentType.CONTENT_TYPE_SONG, ContentType.CONTENT_TYPE_ARTIST],
  market: "LB",
  pageSize: 20,
});

​

Browse

​

When to use which

• Specific known query? Search. The user typed it.
• Discovery / open-ended UX? BrowseFeatured for the home screen, BrowseCharts for “what’s hot”, BrowseGenres → GetGenreContent for filter-driven browsing.
• “What’s new?” UX? BrowseNewReleases.

​

Performance tips

• Large page_size (up to 100) reduces round-trips for paginated browse output.
• Search ranking is not stable across queries — don’t paginate deep beyond what your UI actually shows.
• Charts are recomputed periodically; treat chart entries as a snapshot rather than real-time.