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

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...