Skip to main content

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.

You almost never call this directly — the marketplace website fires it when a listing page opens. Call it only when you build a custom marketplace front end on top of the public API.

When to use

Bump the public view count of a marketplace listing — the number of times its page has been opened. The marketplace site invokes this once per listing per browser session: a refresh in the same session does not double-count, so the counter tracks distinct page opens rather than raw hits. The endpoint records a usage signal only — it does not return any listing content. This endpoint is public — no API key required.

Endpoint

POST https://europe-west1-slideless-ai.cloudfunctions.net/recordMarketplaceView

Auth

None. Do not send an Authorization header.

Request body

{ "slug": "q4-pitch-template" }
FieldTypeRequiredDescription
slugstringyesThe listing whose page was opened.

Response (200)

{
  "success": true,
  "data": {
    "slug": "q4-pitch-template",
    "viewCount": 3121
  }
}
FieldTypeDescription
slugstringThe listing slug.
viewCountnumberThe new total after this view.

Examples

curl

curl -sS -X POST \
  -H "Content-Type: application/json" \
  -d '{ "slug": "q4-pitch-template" }' \
  https://europe-west1-slideless-ai.cloudfunctions.net/recordMarketplaceView

Node.js

const res = await fetch(
  'https://europe-west1-slideless-ai.cloudfunctions.net/recordMarketplaceView',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ slug: 'q4-pitch-template' }),
  }
);

const { data } = await res.json();
console.log(`View count is now ${data.viewCount}`);
To avoid inflating the counter, fire this once per session per listing — for example, guard it behind a sessionStorage flag keyed on the slug.

Errors

StatusCodeCauseFix
400invalid-argumentMissing slug in the bodyInclude slug
404not-foundNo listing with that slugCheck the slug via listMarketplaceListings
405method-not-allowedUsed GET/PUT/etc.Use POST
500internalBackend errorRetry with backoff

Next