Content Presence

1 endpoints from the published OpenAPI import.

GET/api/v1/content/presence/{path}

Live-viewer count SSE stream for the current page

Server-Sent Events stream emitting the current viewer count for {path} on the resolving tenant. Used by the marketplace component sys-proof-live-viewers-pulse. Same-origin EventSource expected (tenant resolves via the Host / X-Content-Domain header).

Query params:

sid (required): opaque session id (UUID v4 from sessionStorage). 8–64 chars, [A-Za-z0-9_-].
i (optional): polling interval in seconds. Server-clamped to [15, 120] (default 30).

Events:

ready — emitted once on connect with the resolved path + interval.
presence — emitted every i seconds with {count, path, interval_s}.

Parameters

Name	In	Type	Required	Description
`path`	path	string	true
`sid`	query	string	true	Opaque per-tab session id from sessionStorage.
`i`	query	integer	false	Polling interval (seconds).

Try it

Examples

cURL

curl -X GET 'https://spideriq.ai/api/v1/content/presence/{path}' \
  -H 'Authorization: Bearer <token>'

Python

import httpx

resp = httpx.get(
    "https://spideriq.ai/api/v1/content/presence/{path}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/content/presence/{path}", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/api/v1/content/presence/{path}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error