Skip to content

API

A versioned HTTP API under /api/v1. Responses use a consistent JSON envelope.

Conventions

  • Base path: /api/v1
  • Success: { "data": ... }; errors: { "error": { "code", "message" } }
  • Auth uses a secure session cookie; sensitive endpoints are rate-limited.

Public endpoints

  • GET /api/v1/health — service health.
  • GET /api/v1/search?q=… — global scholarly search.
  • GET /api/v1/discovery/researchers — provenance-bearing discovered profiles.
  • GET /api/v1/files/<key> — access-controlled file serving.

Research Bulletin

  • GET /api/v1/research-bulletin/search?q=… — search the bulletin series.
  • GET /api/v1/research-bulletin/<slug>/citation — formatted citation export.
  • GET /api/v1/research-bulletin/<slug>/pdf — the canonical PDF of record.
  • GET /research-bulletin/feed.xml — RSS feed of published bulletins.

The API is evolving alongside the platform. Try the live search on the discover page, browse the Research Bulletin, and see the documentation for core concepts.

API · ResearchTrics