Skip to main content
GET
Get one curated section with its members

Authorizations

Authorization
string
header
required

API Key Authentication

Use your API key in the Authorization header:

Key Types:

Secret Keys (Server-Side Only):

  • Format: tybrite_sk_live_* (production) or tybrite_sk_test_* (sandbox)
  • Full read/write access to all endpoints
  • ⚠️ NEVER expose in client-side code or public repositories
  • Required for: write operations, authentication, payment verification, AI recommendations

Publishable Keys (Client-Safe):

  • Format: tybrite_pk_live_* (production) or tybrite_pk_test_* (sandbox)
  • Read-only access (GET requests only, plus POST semantic search)
  • ✅ Safe for client-side JavaScript, mobile apps, and public code
  • Allowed for: browsing products, search, CMS content, pricing queries

Endpoint-Specific Requirements:

  • Authentication endpoints (/v1/auth/*): Secret key required
  • Payment verification (POST /v1/payments/verify): Secret key required
  • AI Recommendations (POST /v1/recommendations): Secret key required
  • Semantic Search (POST /v1/search): Both key types allowed (read-only operation)
  • All write operations: Secret key required
  • All read operations: Both key types allowed

Using a publishable key for restricted operations returns 403 Forbidden.

Path Parameters

slug
string
required

The section's slug, taken from the section list.

Query Parameters

limit
integer

Maximum number of members to return.

Required range: 1 <= x <= 100

Response

The curated section and its members.

A single curated merchandising section with its resolved members. The members are products, merchants, or promotions hand-picked (or auto-curated) by the marketplace operator. Render them as a homepage section and blend them with sponsored placements and organic recommendations as appropriate.

slug
string
required
Example:

"trending-now"

name
string
required
Example:

"Trending now"

placement_kind
enum<string>
required
Available options:
product,
merchant,
promotion
curated
boolean
required

Always true — the members were selected by the marketplace operator.

Example:

true

items
object[]
required
description
string | null