API Reference

Complete reference for the eyalbercovich.com Profile API v1.0.0

Base URL: https://www.eyalbercovich.com

GET/api

Returns an index of all endpoints with descriptions. Self-describing root.

curl https://www.eyalbercovich.com/api

GET/api/profile

Returns Dr. Bercovich's academic profile: identity, specialty, positions, training, credentials, and links.

curl https://www.eyalbercovich.com/api/profile

GET/api/publications

List peer-reviewed publications (12 total).

Query parameters

NameTypeDescription
yearintegerFilter by publication year
journalstringFilter by journal name (partial match)
limitintegerMax results (default 50)
curl "https://www.eyalbercovich.com/api/publications?year=2024"
curl "https://www.eyalbercovich.com/api/publications?journal=radiology"

GET/api/publications/{doi}

Get a single publication by DOI. The DOI must be URL-encoded.

curl "https://www.eyalbercovich.com/api/publications/10.1016%2Fj.crad.2025.107075"

GET/api/clinic

Clinic information: name, address, phone, coordinates, insurance, booking links, hours.

curl https://www.eyalbercovich.com/api/clinic

GET/api/services

Clinical service catalog with English + Hebrew names. Filter by category: diagnostic-ultrasound, sports-imaging, injection, procedure, consultation.

curl "https://www.eyalbercovich.com/api/services?category=injection"

GET/api/research

Research areas and academic affiliations.

GET/api/status

Health check. Returns {ok, version, ts, uptime, services}. Not cached.

GET/api/export.csv

All publications as CSV. Triggers download via Content-Disposition: attachment.

GET/api/openapi.json

OpenAPI 3.1 specification of this API.

Response format

All successful responses use Content-Type: application/json; charset=utf-8. Responses are UTF-8 encoded JSON with pretty-printed formatting (2-space indent) for readability.

Error format

{
  "error": "error_code",
  "error_description": "Human-readable description"
}

CORS

All responses include Access-Control-Allow-Origin: *. Preflight OPTIONS requests are handled.

Caching

Responses include Cache-Control: public, max-age=3600 except /api/status which is no-cache.