Public API

API Documentation

A public REST API to access Mark Osiemo's portfolio data. No authentication required. Rate limited to 30 requests per minute.

Base URL: https://markosiemo.vercel.app

Rate limit: 30 req/min

Endpoints

GET/api/v1/projects

Get all public projects

Query Parameters

featured

booleanFilter featured projects only

status

stringFilter by status: ACTIVE, COMPLETED, ARCHIVED

limit

numberResults per page (max 50, default 10)

page

numberPage number (default 1)

Example Request

GET https://markosiemo.vercel.app/api/v1/projects?featured=true&limit=5

Response Format

{
  "data": [
    {
      "id": "cmnbp7b2p...",
      "title": "Dev Portfolio Platform",
      "slug": "dev-portfolio-platform",
      "description": "Full-stack portfolio...",
      "techStack": ["Next.js", "TypeScript"],
      "githubUrl": "https://github.com/...",
      "liveUrl": "https://...",
      "status": "ACTIVE",
      "featured": true,
      "views": 120,
      "likes": 45,
      "createdAt": "2024-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "total": 6,
    "page": 1,
    "limit": 5,
    "totalPages": 2
  }
}