Developer API

PrepSPSC Developer API

Build on top of Sikkim's most comprehensive PYQ database. Semantic search, mock test generation, progress analytics, and more — all accessible via a simple REST API.

Free tier: 10 RPM1,000 requests/monthNo credit card required

Commercial Use Attribution Requirement

Anyone using this API for commercial purposes MUST provide attribution by linking back to PrepSPSC.

Required attribution format:

PYQ data provided by <a href="https://prepspsc.com">PrepSPSC</a>

This includes but is not limited to: websites, applications, trading bots, research reports, or any service that generates revenue. Personal use is permitted without attribution.

Get your API key
Sign up to get a free API key instantly. No approval required.

ClawHub / OpenClaw Access

This API is also available as an OpenClaw skill on ClawHub, making it accessible to 100K+ AI agents.

Install: npx clawdhub install prepspsc-pyq
Skill ID: prepspsc-pyq@1.0.0
View on ClawHub Registry

MCP Server (for AI Agents)

Connect directly from any MCP-compatible AI agent. All 11 tools show up natively — just type "generate me an SPSC mock test".

Add to your MCP client settings:

{
  "mcpServers": {
    "prepspsc": {
      "command": "node",
      "args": ["mcp-server/dist/index.js"],
      "env": {
        "PREPSPSC_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}
Agent Protocol Discovery|MCP Tool Definitions

AI Question Generation

Use the 7,400+ real PYQs as few-shot reference examples to generate unlimited new questions with any LLM. Each question includes topics, cognitive level, difficulty, and exam metadata — everything your AI needs to match real SPSC exam standards.

  1. Fetch exam patterns to understand subject distribution
  2. Search for reference questions on your target topic
  3. Use returned questions as few-shot examples in your AI prompt
  4. Match the format: question + 4 options + correct answer + explanation

What you can build

Semantic PYQ Search

Search previous year questions using natural language with AI-powered vector similarity.

Mock Test Generation

Generate exam-pattern mock tests from a curated bank of real PYQ questions.

Progress Tracking

Track study streaks, XP, test scores, and topic-wise performance analytics.

Leaderboard

Access real-time leaderboards for competitive motivation among aspirants.

Bookmarks

Save and retrieve bookmarked questions for spaced repetition review.

Free Tier Includes

  • 10 requests per minute rate limit
  • 1,000 API calls per month
  • Full access to PYQ search and mock tests
  • Semantic vector search with AI embeddings
  • JSON responses with detailed metadata
  • No credit card required

Quick Start

Once you have your API key, making requests is simple:

curl -X POST https://qqqditxzghqzodvauxth.supabase.co/functions/v1/pyq-api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Sikkim history", "subject": "History", "limit": 5}'

Authentication

All API requests must include your API key in the Authorization: Bearer header:

// Using fetch
const response = await fetch("https://qqqditxzghqzodvauxth.supabase.co/functions/v1/pyq-api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk_live_your_key_here"
  },
  body: JSON.stringify({
    query: "fundamental rights Article 14",
    subject: "Indian Polity",
    limit: 10
  })
});

const data = await response.json();
console.log(data.questions);

Your API key is hashed on our servers. We never store the raw key. Keep it secret and never expose it in client-side code.

PrepSPSC Developer API — Built for exam preparation app builders.

Need help? Contact prepspsc@protonmail.com