Developer Platform

VaxInfo API Documentation

Build vaccine search experiences with API keys, analytics tracking, and embeddable widgets.

Core Endpoints

GET /api/search - intelligent disease search and recommendations
GET /api/vaccines - paginated disease and vaccine dataset
GET /api/analytics - search trends and demand analytics
GET /api/dashboard/export - CSV/PDF export
GET /api/health - health and DB status check
GET/POST/PATCH/DELETE /api/developer/keys - API key lifecycle

Authentication

Use x-api-key or Authorization: Bearer.
Create/list/rotate/revoke/delete keys via /api/developer/keys (signed-in users).
Usage metrics via /api/developer/usage.
Anonymous requests are supported with stricter rate limits.

Search API Example

curl "https://your-domain/api/search?disease=measles%20and%20polio%20vaccines" \
  -H "x-api-key: <YOUR_API_KEY>"

Key Rotation Example

curl -X PATCH "https://your-domain/api/developer/keys" \
  -H "Content-Type: application/json" \
  -b "next-auth.session-token=<YOUR_SESSION_TOKEN>" \
  -d '{"keyId":"<KEY_ID>","action":"rotate"}'

Response Highlights

Intent detection (`search`, `explanation`, `recommendation`, `analytics`).
Multi-disease result arrays with severity and mandatory tags.
Recommendation payloads for child schedule and travel contexts.
Backward-compatible top match fields (`disease`, `vaccines`, `matchType`, `score`).

Embeddable Widget

Use the hosted widget page or embed it directly in third-party websites.

<iframe
  src="https://your-domain/embed"
  title="VaxInfo Search Widget"
  width="420"
  height="560"
  style="border:0;border-radius:14px;overflow:hidden"
></iframe>

Open widget preview

Loading API key manager...