Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/sam-shervin/space7/llms.txt

Use this file to discover all available pages before exploring further.

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.
participant_count
number
Number of participants currently in the space.
tags
array
Tags associated with the space.

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" }]
//   }
// ]

Build docs developers (and LLMs) love