HTTP API

Base URL

Append the paths below. In production this matches your public site origin.

https://westden4ik.sviridoff.space/api/v1

MCP server for Cursor

Standalone binaries that call this API (posts, projects, books, services, optional admin CRM). Same stack as the live site.

Download builds

Studio and client APIs (/api/v1/admin/*, /api/v1/client/*) require authentication and are not listed here - see the repository README and packages/mcp-server for tooling.

Posts & engagement

GET/api/v1/posts
Paginated published posts. Query: page, pageSize, type (TEXT|VIDEO|IMAGE), tag, q, publishedFrom, publishedTo, hasCode.
GET/api/v1/posts/{slug}
Single published post with body, tags, series nav, like counts.
GET/api/v1/posts/{slug}/comments
Approved comments (threaded). Query: commentsPage, commentsPageSize, commentsSort.
POST/api/v1/posts/{slug}/comments
Submit a comment for moderation (public).
POST/api/v1/posts/{slug}/like
Like a post (anonymous cookie/session aware).
DELETE/api/v1/posts/{slug}/like
Remove like.

Projects, books, photos

GET/api/v1/projects
Paginated projects. Query: page, pageSize, tag.
GET/api/v1/books
Paginated books. Query: page, pageSize, tag.
GET/api/v1/photos
Photo entries / gallery data with pagination and optional tag.

Services & site

GET/api/v1/services
Published service offerings (pricing, timeline, etc.).
GET/api/v1/services-page
CMS copy for the public services page (hero, process, CTA, translations).
POST/api/v1/services/inquiries
Submit a service inquiry (email, message, optional Telegram and serviceId).
GET/api/v1/site-settings
Public branding strings and outbound footer links.
GET/api/v1/about
Public about page payload (bio HTML, portrait asset).

Discovery & analytics

GET/api/v1/search
Site search across posts, projects, books. Query: q (required), page, pageSize.
GET/api/v1/tags/{resource}
Tag counts for tag clouds. resource = posts | projects | photos | books.
GET/api/v1/post-series/{slug}
Series navigation for a blog series slug.
POST/api/v1/engagement
Lightweight analytics (e.g. post view, outbound clicks). Rate limited.