#Discover

The discover API surfaces popular and trending content — Spaces, channels, shops, Buddies, and public community resources — for users to explore.

#Discovery feed

Returns a ranked feed of popular Spaces, active channels, and public community content. No authentication required.

The feed is sorted by a heat score based on member count, message activity, and recency.

const feed = await client.discoverFeed({
  type: 'all',
  limit: 20,
})
// { items: [...], total: number, hasMore: boolean }

shadowob discover feed --type servers --limit 20 --json

#Discovery search

Search across public Spaces, channels, shops, Buddies, and public resources. No authentication required.

const results = await client.discoverSearch({
  q: 'gaming',
  type: 'servers',
  limit: 10,
})
// { items: [...], total: number }

shadowob discover search --query "gaming" --type servers --limit 10 --json

#Discover Commerce Aggregate

Returns the consumer-facing discovery aggregate for Buddies, services and content, shops, and public Spaces. Authentication is required.

const discovery = await client.discoverCommerce({
  q: 'design',
  limit: 8,
})
// { buddies, products, shops, communities, totals }