Documentation Index
Fetch the complete documentation index at: https://docs.slideless.ai/llms.txt
Use this file to discover all available pages before exploring further.
For most use cases, the
slideless CLI is easier than calling this endpoint directly. The CLI command equivalent is slideless listing get <slug> (or slideless listing get <slug> --json).When to use
Inspect one marketplace listing in detail — its README, tags, counters, and the file manifest of the pinned version. Works for bothpublic and unlisted listings: an unlisted listing is reachable here by anyone who knows its slug — the slug is the only secret.
This endpoint is public — no API key — and its responses are cached.
Endpoint
Auth
None. Do not send anAuthorization header.
Query parameters
| Param | Type | Description |
|---|---|---|
slug | string | The listing slug. Required. |
Response (200)
| Field | Type | Description |
|---|---|---|
slug, title, description | string | Display metadata. |
readme | string | null | Long-form Markdown shown on the listing page. |
kind | "presentation" | "app" | "plan" | The listing’s purpose. See The three kinds. |
interactive | boolean | Whether the listing is interactive. A badge, not a category — always true for app. |
category | string | null | Category bucket. |
tags | string[] | Search tags. |
techStack | string[] | Technologies the listing is built with or built for. Free-form lowercase technology slugs (e.g. nextjs, firebase). May be empty. See Tech stack. |
status | "public" | "unlisted" | Discoverability. See Public vs unlisted. |
version | number | The pinned source version. |
stars, remixCount, viewCount | number | Public counters — stars, slideless remix runs, and listing-page opens. |
remixedFromSlug | string | null | If this listing was published from a remixed deck, the source listing’s slug; otherwise null. See Remix lineage. |
remixedFromTitle | string | null | The source listing’s title, or null. |
entry | string | The deck’s entry HTML file. |
files | array | Manifest of the pinned version — path and bytes per file. |
totalBytes | number | Sum of all file sizes. |
createdAt, updatedAt | ISO 8601 string | Timestamps. |
marketplaceUrl | string | The public website URL. |
Examples
curl
Node.js
Errors
| Status | Code | Cause | Fix |
|---|---|---|---|
400 | invalid-argument | Missing slug query parameter | Append ?slug=… |
404 | not-found | No listing with that slug | Check the slug via listMarketplaceListings |
405 | method-not-allowed | Used POST/PUT/etc. | Use GET |
500 | internal | Backend error | Retry with backoff |
Next
- GET /listMarketplaceListings — browse the catalog.
- GET /listMarketplaceRemixes — listings remixed from this one.
- POST /recordMarketplaceView — bump the view counter.
- POST /recordMarketplaceRemix — record a remix.