API reference

Base URL: https://bookapp-api-485070520831.us-central1.run.app. Configure locally with NEXT_PUBLIC_API_BASE_URL.

POST /v1/intelligence

Request JSON with at least one of title or isbn. Optional: locale, depth (brief | standard | deep).

POST https://bookapp-api-485070520831.us-central1.run.app/v1/intelligence
Content-Type: application/json

{
  "title": "The Left Hand of Darkness",
  "depth": "brief"
}

GET /healthz

Returns { "ok": true } when the service is up.

GET /v1/version

Returns API name and version string.

Errors

Error responses use a consistent JSON envelope: error.code, error.message, optional error.details, and requestId.

Try it

Sends a real request from your browser. Ensure the API allows this origin in CORS (production: https://bookapp.tech; local dev: http://localhost:3000).

Book title