Get one curated section with its members
Returns a single curated merchandising section together with its resolved members. The members are products, merchants, or promotions hand-picked (or auto-curated) by the marketplace operator to merchandise the storefront. Requires a marketplace operator key.
Render the section as a homepage rail and blend it with sponsored placements and organic recommendations as appropriate.
Use the optional limit parameter to cap how many members come back.
Authorizations
API Key Authentication
Use your API key in the Authorization header:
Key Types:
Secret Keys (Server-Side Only):
- Format:
tybrite_sk_live_*(production) ortybrite_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) ortybrite_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
The section's slug, taken from the section list.
Query Parameters
Maximum number of members to return.
1 <= x <= 100Response
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.
"trending-now"
"Trending now"
product, merchant, promotion Always true — the members were selected by the marketplace operator.
true

