Public API

Build on World Wide (soon)

The World Wide Public API is not generally available yet. We are documenting the rules and roadmap first so integrations remain stable once launched.

Status

The supported external API surface is in design and private preview. Internal endpoints that power the web app may change without notice.

Planned base URL

https://world-wide.org/api/v1

Auth header

Authorization: Bearer <service credential>

Contract-first

We document the API contract (OpenAPI + conventions) before committing to a supported integration surface.

Versioned and stable

Public API endpoints are versioned under /api/v1 on world-wide.org with explicit deprecation windows.

Secure by default

Sensitive access details stay protected, and high-cost endpoints ship with budget and abuse protections before exposure.

Predictable auth

Public access uses revocable, least-privilege service principals. Browser sessions remain reserved for human first-party flows.

Roadmap

Phase 0

Contract + docs foundation

Lock the rules (versioning, auth, pagination, errors) and publish a roadmap before implementing GA behavior.

Phase 1

Read-only Public Data API

Stabilize catalog endpoints (domains, seminars, talks, lectures, jobs, grants, ePosters, conferences) with consistent envelopes and rate limits.

Phase 2

Institutional integrations

Add webhook notifications and institutional OIDC where service principals are insufficient.

Phase 3

Submission APIs (write surfaces)

Introduce idempotency, strong abuse controls, audit provenance, and policy alignment for write endpoints.

Repository note: the canonical contract lives in docs/PUBLIC_API.md.

We use essential cookies to run the site. Analytics cookies are optional and help us improve World Wide. Learn more.

Public API | World Wide - World Wide