Jay Shah — Developer API & Data Resources

Programmatic, machine-readable data feeds and OpenAPI specifications for AI agents, crawlers, and developers querying content from jayshah.dev.

Discovery Standards

This site follows modern agentic and web discovery protocols:

LLMs Index: /llms.txt • Plain text summary index for AI agents (llmstxt.org).
LLMs Full Context: /llms-full.txt • Consolidated context bundle with article digests and project architectures.
OpenAPI Specification: /api/openapi.json • OpenAPI 3.1 specification.
MCP Server Manifest: /.well-known/mcp.json • Model Context Protocol tools definition.
Markdown Content Negotiation: Supports Accept: text/markdown across all content pages with Vary: Accept.
XML Sitemap: /sitemap-index.xml • Full index of canonical URLs.
RSS 2.0: /rss.xml • Publication feed.

Available API Endpoints

GET /api/posts.jsonView JSON →

Articles & Research Notes Feed

Returns all published technical blog posts with title, slug, canonical URLs, publication date, description, tags, and reading time estimates.

curl -s https://jayshah.dev/api/posts.json

GET /api/projects.jsonView JSON →

Engineering Projects Feed

Returns open-source machine learning projects, developer extensions, and research code repositories.

curl -s https://jayshah.dev/api/projects.json

GET /api/reads.jsonView JSON →

Curated Reading List Feed

Returns curated bibliography of machine learning papers, systems posts, and research notes.

curl -s https://jayshah.dev/api/reads.json

GET /api/info.jsonView JSON →

Site Information & Author Metadata

Returns author background, research focus areas, social endpoints, feeds, and discovery URLs.

curl -s https://jayshah.dev/api/info.json

GET /api/openapi.jsonView JSON →

OpenAPI 3.1.0 Specification

Full machine-readable OpenAPI specification defining all endpoints, schemas, parameters, and error models.

curl -s https://jayshah.dev/api/openapi.json

Error Handling (RFC 7807)

API errors return structured JSON conforming to RFC 7807 Problem Details, including error codes, human-readable descriptions, and resolution guidance for autonomous agents:

{
  "type": "https://jayshah.dev/api/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "error": "NOT_FOUND",
  "message": "The requested API endpoint was not found.",
  "resolution": "Check the available endpoints in our OpenAPI specification at https://jayshah.dev/api/openapi.json.",
  "documentation_url": "https://jayshah.dev/api/openapi.json"
}