Skip to main content

CVin.Bio Developer Resources & API Documentation

CVin.Bio exposes a public, read-mostly API and Model Context Protocol (MCP) server so developers and AI agents can query live curated tech jobs, aggregated tech news, and public candidate profiles. No authentication is required for public read endpoints.

CVin.Bio Machine-Readable Specifications

CVin.Bio REST API Endpoints

  • GET /api/jobs?page=1&limit=20&q=&type=&loc=remote

    Paginated feed of curated tech jobs. Returns { jobs[], total, page, limit, hasMore }. Optional Supabase bearer auth personalizes match scores.

    operationId: listJobs

  • GET /api/jobs/{id}

    Full detail for one public job, including sanitized description HTML when published.

    operationId: getJob

  • GET /api/news?limit=10

    Recent aggregated items from tier-1 tech news sources (Hacker News, TechCrunch, The Verge, Ars Technica…).

    operationId: listTechNews

  • GET /api/profile/{username}

    Flattened public candidate profile for a cvin.bio username slug.

    operationId: getPublicProfile

  • POST /api/contact

    Submit a support/partnership message. JSON body: { email, purpose, message }. Rate limited to 5/hour per IP.

    operationId: submitContactMessage

CVin.Bio MCP Tools

The same data is available to AI agents via the Model Context Protocol at https://cvin.bio/mcp. Point any MCP client (Claude, ChatGPT, Cursor) at the Streamable HTTP endpoint — tool listing is public.

  • search_jobsSearch curated tech jobs by keyword, company, or location.
  • get_jobFetch one job listing with full description and apply link.
  • platform_statsLive counts of jobs, companies, and public profiles on CVin.Bio.

CVin.Bio Webhooks & Event Notifications

CVin.Bio provides real-time job updates and profile indexing events via polling feeds and webhooks:

  • GET /rss.xml — RSS 2.0 feed of new technology jobs and platform news
  • GET /api/jobs?sort=latest — polling feed for new job listings
  • POST /api/contact — partner webhook registration requests (email hi@cvin.bio)

CVin.Bio Rate Limits

API responses carry standard rate-limit headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (RFC 9331 draft) plus the legacy X-RateLimit-* set. Read endpoints allow 300 requests/minute per IP; contact submissions are limited to 5/hour per IP. On HTTP 429, honor the Retry-After header before retrying.

CVin.Bio Errors

All API errors return JSON — never HTML pages — shaped as { error, code?, hint? }. Unknown /api/* paths return a JSON 404 pointing back to this document and the OpenAPI spec.

API Versioning & Deprecation Policy

CVin.Bio APIs use URL-path major versioning (current stable: /api/* alias of /v1/api/*). When an endpoint or version is scheduled for deprecation, CVin.Bio guarantees a minimum 180-day notice period and signals deprecation on every affected response via standard HTTP headers:

  • Deprecation: @<unix-timestamp> — RFC 9261 deprecation header
  • Sunset: <HTTP-date> — RFC 8594 sunset date header
  • Link: <url>; rel="deprecation" — link to migration documentation

Breaking changes are never introduced within a major version. Non-breaking additive changes may be introduced at any time.

Developer Support

Questions about the API or developer integrations? Email hi@cvin.bio or use the contact page.