GET /getMarketplaceListing

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 both public 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

GET https://europe-west1-slideless-ai.cloudfunctions.net/getMarketplaceListing?slug={slug}

Auth

None. Do not send an Authorization header.

Query parameters

Param	Type	Description
`slug`	string	The listing slug. Required.

Response (200)

{
  "success": true,
  "data": {
    "slug": "q4-pitch-template",
    "title": "Q4 Pitch Template",
    "description": "Investor-ready pitch skeleton — 8 slides, placeholder copy.",
    "readme": "# Q4 Pitch Template\n\nA clean 8-slide skeleton…",
    "kind": "presentation",
    "interactive": false,
    "category": "business",
    "tags": ["pitch", "startup", "investor"],
    "techStack": ["html", "css"],
    "status": "public",
    "version": 3,
    "stars": 128,
    "remixCount": 540,
    "viewCount": 3120,
    "remixedFromSlug": null,
    "remixedFromTitle": null,
    "entry": "index.html",
    "files": [
      { "path": "index.html", "bytes": 24800 },
      { "path": "styles.css", "bytes": 4100 }
    ],
    "totalBytes": 28900,
    "createdAt": "2026-04-15T10:00:00.000Z",
    "updatedAt": "2026-04-18T15:30:00.000Z",
    "marketplaceUrl": "https://slideless.ai/marketplace/q4-pitch-template"
  }
}

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

curl -sS "https://europe-west1-slideless-ai.cloudfunctions.net/getMarketplaceListing?slug=q4-pitch-template"

Node.js

const slug = 'q4-pitch-template';
const res = await fetch(
  `https://europe-west1-slideless-ai.cloudfunctions.net/getMarketplaceListing?slug=${slug}`
);

const { data: listing } = await res.json();
console.log(`${listing.title} (${listing.kind}) — v${listing.version} — ★${listing.stars}`);

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

GET /listMarketplaceListings — browse the catalog.
GET /listMarketplaceRemixes — listings remixed from this one.
POST /recordMarketplaceView — bump the view counter.
POST /recordMarketplaceRemix — record a remix.

Getting Started

Why Slideless

Concepts

CLI

Guides

Plugin Skills

Claude Desktop (MCP)

Advanced: HTTP API

When to use

Endpoint

Auth

Query parameters

Response (200)

Examples

curl

Node.js

Errors

Next

​When to use

​Endpoint

​Auth

​Query parameters

​Response (200)

​Examples

​curl

​Node.js

​Errors

​Next

When to use

Endpoint

Auth

Query parameters

Response (200)

Examples

curl

Node.js

Errors

Next