Get Trending Spaces

Retrieve a list of trending public spaces.

Overview

Returns a list of trending spaces. Only public spaces are included in the response. No authentication is required.

Endpoint

GET /api/spaces/trending

No authentication required. This is a public endpoint.

Request

Query parameters

limit · number

Maximum number of spaces to return. Defaults to 10.

visibility · string

Always set to "public". Private spaces are never returned by this endpoint.

Response

Returns an array of Space objects.

space_id · string

Unique identifier for the space.

title · string

Display title of the space.

description · string

Short description of the space.

visibility · string

Visibility of the space. Always "public" for results from this endpoint.

creator · object

The user who created the space.

Show creator properties

user_id · string

Unique identifier of the creator.

username · string

Username of the creator.

profile_picture · string

URL of the creator’s profile picture.

participant_count · number

Number of participants currently in the space.

tags · array

Tags associated with the space.

Show tag properties

tag_id · number

Unique identifier of the tag.

tag_name · string

Display name of the tag.

Example

TypeScript

import { getTrendingSpaces } from "./api/Spaces";

// Fetch the default 10 trending spaces
const spaces = await getTrendingSpaces();

// Fetch up to 25 trending spaces
const moreSpaces = await getTrendingSpaces({ limit: 25 });

console.log(spaces);
// [
//   {
//     space_id: "abc123",
//     title: "Morning Standup",
//     description: "Daily sync for remote teams",
//     visibility: "public",
//     creator: { user_id: "u1", username: "alice", profile_picture: "https://..." },
//     participant_count: 42,
//     tags: [{ tag_id: 1, tag_name: "work" }]
//   }
// ]