openlibrary-mcp-server

Previous value: -"Max works to return."New value: +"Max works to return; values above 100 apply 100 when limit clamping is enabled."

Previous value: -100New value: +9007199254740991

Previous value: -"Set when the requested author ID was merged into a different canonical ID."New value: +"Guidance for a merged author ID or a requested limit above the page ceiling."

Previous value: -"Reminder that the URL always returns HTTP 200; a placeholder GIF is served when no cover exists."New value: +"Reminder that the image is unverified and a missing cover may return a placeholder."

Previous value: -"Direct HTTPS URL to the cover image. The Covers API returns HTTP 200 for all requests — a 1×1 placeholder GIF is returned when no cover exists for the identifier."New value: +"Direct HTTPS URL to the cover image; not fetched or verified by this tool."

Previous value: -"Identifiers to resolve, 1–50, all of the type named by id_type. Resolved editions come back in request order."New value: +"Identifiers to resolve, 1–1000 raw entries, all of the type named by id_type. Exact duplicate strings collapse in first-occurrence order; the first 50 distinct entries are processed, including malformed entries, and remaining strings are returned in unprocessed."

Previous value: -50New value: +1000

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "editions",
-      "unresolved"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "unprocessed",
+      "editions",
+      "unresolved"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "description": "Cataloged edition or printing statement, preserved verbatim. Absent when not recorded.",
+  "type": "string"
+}

Previous value: -"3-letter ISO language code (e.g., \"eng\"). Absent when not recorded."New value: +"First cataloged language code (e.g., \"eng\"). Absent when not recorded; languages contains the complete cataloged list."

Added value: +{
+  "description": "All cataloged language codes in upstream order. Absent when no languages are recorded.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Cataloged physical format or binding, preserved verbatim. Absent when not recorded.",
+  "type": "string"
+}

Previous value: -"Present when author lookups for some editions failed or were skipped: names those editions, whose authors are missing or shown by author ID. Absent when every lookup completed."New value: +"Present when the identifier batch was shortened or author lookups failed or were skipped; includes all applicable guidance."

Added value: +{
+  "description": "Remaining distinct identifiers in input order, preserved verbatim for another call. Empty when the entire batch was processed.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Max editions to return. Prefer 10–20 for exploration."New value: +"Max editions to return; values above 100 apply 100 when limit clamping is enabled. Prefer 10–20 for exploration."

Previous value: -100New value: +9007199254740991

Added value: +{
+  "description": "Cataloged edition or printing statement, preserved verbatim. Absent when not recorded.",
+  "type": "string"
+}

Added value: +{
+  "description": "Cataloged physical format or binding, preserved verbatim. Absent when not recorded.",
+  "type": "string"
+}

Previous value: -"Set when the requested work ID was merged into a different canonical ID."New value: +"Guidance for a merged work ID or a requested limit above the page ceiling."

Previous value: -100New value: +9007199254740991

Previous value: -"Subject name. Normalized before lookup — lowercased with spaces converted to underscores (e.g., \"Science Fiction\" → \"science_fiction\") — so varying case or spacing does not change the result."New value: +"Subject name. Normalized before lookup — trimmed, lowercased, and internal whitespace converted to underscores (e.g., \" Science Fiction \" → \"science_fiction\") — so varying case or surrounding whitespace does not change the result."

Previous value: -"Machine-readable failure mode."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_subject`: The subject is empty after trimming whitespace. Other values are possible when a failure originates below the handler."

Added value: +[
+  "invalid_subject"
+]

Previous value: -"Recovery guidance when work_count is 0 — echoes the subject and suggests alternatives. Absent when works are found."New value: +"Recovery guidance when work_count is 0, composed with requested/applied page limits and next offset when the limit was reduced to 100. Absent when neither applies."

Previous value: -"Set when the requested work ID was merged into a different canonical ID, and when the text output caps a long subject list (naming the omitted count and the complete array in structuredContent). Absent when neither applies."New value: +"Set when the requested work ID was merged into a different canonical ID. Absent otherwise."

Previous value: -"Max results to return."New value: +"Max results to return; values above 100 apply 100 when limit clamping is enabled."

Previous value: -100New value: +9007199254740991

Previous value: -"Guidance when the page is empty (how to vary a name that matched nothing, or which offset to retry when offset ran past the end) or when the text output capped a per-author list. Absent when neither applies."New value: +"Guidance for an empty page or a requested limit above the page ceiling. Absent when neither applies."

Previous value: -100New value: +9007199254740991

Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_language_code`: A 2-letter language value has no MARC equivalent, so no filter could be applied. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_search_query`: Open Library rejects the search query with HTTP 422. `unknown_language_code`: A 2-letter language value has no MARC equivalent, so no filter could be applied. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "unknown_language_code"
-]New value: +[
+  "invalid_search_query",
+  "unknown_language_code"
+]

Previous value: -"Guidance when the page is empty (how to broaden a query that matched nothing, or which offset to retry when offset ran past the end) or when the text output capped a per-work list. Absent when neither applies."New value: +"Guidance when the page is empty or a requested page limit was reduced to 100. Absent when neither applies."

Added value: +{
+  "additionalProperties": false,
+  "description": "One provider-ranked edition selected by query syntax and field filters, when supplied. Unfielded terms need not all match this edition; this is not every edition record.",
+  "properties": {
+    "edition_id": {
+      "description": "Provider-selected edition OLID (OL…M). Pass to openlibrary_get_edition with id_type \"olid\".",
+      "type": "string"
+    },
+    "languages": {
+      "description": "Selected edition language codes, when supplied.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "publishers": {
+      "description": "Selected edition publisher names, when supplied.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "title": {
+      "description": "Selected edition title, when supplied.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "edition_id"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Provider-reported matching-edition count for this search, when supplied. Distinct from the work total edition_count; may be present without a selected edition.",
+  "type": "number"
+}

Previous value: -"Every subject tag the search index returned for this work. The text output caps the rendered list; this array is complete. Absent when no subjects are tagged. For the work record's own curated subject lists (places, times, people), use openlibrary_get_work."New value: +"Every subject tag the search index returned for this work. Absent when no subjects are tagged. For the work record's own curated subject lists (places, times, people), use openlibrary_get_work."

Previous value: -100New value: +9007199254740991

Previous value: -"Passages containing the match, with the upstream highlight markers removed. The text output caps how many are rendered per item; this array is complete."New value: +"Every passage containing the match, with the upstream highlight markers removed."

Previous value: -"Guidance when the page is empty (how to broaden a query that matched nothing, or which offset to retry when offset ran past the end) or when the text output capped a per-item snippet list. Absent when neither applies."New value: +"Guidance for an empty page or a requested limit above the page ceiling. Absent when neither applies."

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library, names a record that is not an author (a work or edition OLID), or redirects to no reachable author. Other values are possible when a failure originates below the handler."

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "total",
-      "author_id",
-      "works"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "offset",
+      "author_id",
+      "works"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library, names a record that is not an author (a work or edition OLID), or redirects to no reachable author. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "Zero-based offset of the first returned result — echoes the requested offset, so an empty page still records the offset that produced it.",
+  "type": "number"
+}

Previous value: -"The identifier value, validated against id_type before the URL is built. For \"id\": a numeric cover or photo ID from work/edition/author data. For \"isbn\": 10 or 13 digits, hyphens optional. For \"olid\": an edition OLID (OL…M) for target \"book\", an author OLID (OL…A) for target \"author\"."New value: +"The identifier value, validated against id_type before the URL is built. For \"id\": a numeric cover or photo ID from work/edition/author data. For \"isbn\": 10 or 13 digits, hyphens optional — an ISBN-10 may end in an X check digit (e.g., 080442957X). For \"olid\": an edition OLID (OL…M) for target \"book\", an author OLID (OL…A) for target \"author\"."

Previous value: -"One identifier value. For ISBN: 10 or 13 digits, hyphens optional. For OCLC: numeric string. For LCCN: string as-is. For OLID: Open Library edition ID (e.g., OL7353617M)."New value: +"One identifier value. For ISBN: 10 or 13 digits, hyphens optional — an ISBN-10 may end in an X check digit (e.g., 080442957X). For OCLC: numeric string. For LCCN: string as-is. For OLID: Open Library edition ID (e.g., OL7353617M)."

Previous value: -"Authors credited for this edition. Empty only when neither the edition nor its parent work records an author."New value: +"Authors credited for this edition. Empty when neither the edition nor its parent work records an author, or when the lookup of the parent work failed or was skipped — the notice names those editions."

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No identifier in the batch resolved to an edition. `invalid_identifier`: Every identifier in the batch is malformed for the specified id_type. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: No identifier in the batch resolved to an edition. `invalid_identifier`: Every identifier in the batch is malformed for the specified id_type. `upstream_unavailable`: Open Library's batch edition lookup answered with an HTTP error status other than 429, or with an HTML page instead of JSON. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "not_found",
-  "invalid_identifier"
-]New value: +[
+  "not_found",
+  "invalid_identifier",
+  "upstream_unavailable"
+]

Added value: +{
+  "description": "Present when author lookups for some editions failed or were skipped: names those editions, whose authors are missing or shown by author ID. Absent when every lookup completed.",
+  "type": "string"
+}

Previous value: -"Open Library Work ID (OL…W). A leading \"/works/\" prefix is stripped if provided."New value: +"Open Library Work ID. Format: OL…W (e.g., \"OL45804W\"), optionally prefixed \"/works/\". Not an ISBN — resolve an ISBN to its work with openlibrary_get_edition (id_type \"isbn\")."

Added value: +"^(?:\\/works\\/)?OL\\d+W$"

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "total",
-      "work_id",
-      "editions"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "offset",
+      "work_id",
+      "editions"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Parent Work ID. Usually matches the requested work_id."New value: +"Parent Work ID. Usually matches the top-level work_id."

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library, or it redirects to no reachable work. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "Set when the requested work ID was merged into a different canonical ID.",
+  "type": "string"
+}

Added value: +{
+  "description": "Zero-based offset of the first returned result — echoes the requested offset, so an empty page still records the offset that produced it.",
+  "type": "number"
+}

Previous value: -"Open Library Work ID."New value: +"Canonical Open Library Work ID the editions were found under — differs from the requested work_id when that ID was merged into this work."

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "subject_name",
-      "subject_key",
-      "work_count",
-      "works"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "subject_name",
+      "subject_key",
+      "work_count",
+      "offset",
+      "works"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "description": "Zero-based offset of the first returned result — echoes the requested offset, so an empty page still records the offset that produced it.",
+  "type": "number"
+}

Previous value: -"Open Library Work ID. Format: OL…W (e.g., \"OL45804W\"). A leading \"/works/\" prefix is stripped if provided."New value: +"Open Library Work ID. Format: OL…W (e.g., \"OL45804W\"), optionally prefixed \"/works/\". Not an ISBN — resolve an ISBN to its work with openlibrary_get_edition (id_type \"isbn\")."

Added value: +"^(?:\\/works\\/)?OL\\d+W$"

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library, or it redirects to no reachable work. Other values are possible when a failure originates below the handler."

Previous value: -"Disclosure when the text output caps a long list — names the omitted count and points to the complete array in structuredContent. Absent when nothing was capped."New value: +"Set when the requested work ID was merged into a different canonical ID, and when the text output caps a long subject list (naming the omitted count and the complete array in structuredContent). Absent when neither applies."

Previous value: -"Canonical Open Library Work ID (OL…W)."New value: +"Canonical Open Library Work ID (OL…W) — differs from the requested work_id when that ID was merged into this work."

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "available_to_borrow": {
-        "description": "True when the book can be borrowed.",
-        "type": "boolean"
-      },
-      "available_to_browse": {
-        "description": "True when the book can be browsed for free.",
-        "type": "boolean"
-      },
-      "available_to_waitlist": {
-        "description": "True when a waitlist is available.",
-        "type": "boolean"
-      },
-      "is_lendable": {
-        "description": "True when the book can be lent.",
-        "type": "boolean"
-      },
-      "is_previewable": {
-        "description": "True when a limited preview is available.",
-        "type": "boolean"
-      },
-      "is_readable": {
-        "description": "True when the book is freely readable online.",
-        "type": "boolean"
-      },
-      "is_restricted": {
-        "description": "True when access is restricted.",
-        "type": "boolean"
-      },
-      "openlibrary_edition": {
-        "description": "Edition OLID the availability check was resolved against.",
-        "type": "string"
-      },
-      "status": {
-        "description": "Availability status string from Internet Archive.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "available_to_browse",
-      "available_to_borrow",
-      "available_to_waitlist",
-      "is_readable",
-      "is_lendable",
-      "is_previewable",
-      "is_restricted"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "available_to_borrow": {
+        "description": "True when the book can be borrowed. Absent when not reported.",
+        "type": "boolean"
+      },
+      "available_to_browse": {
+        "description": "True when the book can be browsed for free. Absent when not reported.",
+        "type": "boolean"
+      },
+      "available_to_waitlist": {
+        "description": "True when a waitlist is available. Absent when not reported.",
+        "type": "boolean"
+      },
+      "is_lendable": {
+        "description": "True when the book can be lent. Absent when not reported.",
+        "type": "boolean"
+      },
+      "is_previewable": {
+        "description": "True when a limited preview is available. Absent when not reported.",
+        "type": "boolean"
+      },
+      "is_readable": {
+        "description": "True when the book is freely readable online. Absent when not reported.",
+        "type": "boolean"
+      },
+      "is_restricted": {
+        "description": "True when access is restricted. Absent when not reported.",
+        "type": "boolean"
+      },
+      "openlibrary_edition": {
+        "description": "Edition OLID the availability check was resolved against. Absent when not reported.",
+        "type": "string"
+      },
+      "status": {
+        "description": "Availability status from Internet Archive, e.g. \"open\" (freely readable), \"borrow_available\", \"borrow_unavailable\", \"private\", or \"error\" (the lending lookup failed, so no flags accompany it). \"unknown\" when Open Library sent no status.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Live reading availability from Internet Archive. Present when include_availability is true and the work has an Internet Archive item. Null when include_availability is true but no IA item exists."New value: +"Live reading availability from Internet Archive, present when include_availability is true. Open Library leaves flags out for some works — an absent flag is unknown, not false. Null means no availability was returned for the work: always so without an Internet Archive item, and sometimes so for a work that has one."

Previous value: -"Machine-readable failure mode."New value: +"Machine-readable failure mode. Declared by this tool: `upstream_unavailable`: Open Library's full-text search answered HTTP 200 without a result set — no hits object carrying a total. Other values are possible when a failure originates below the handler."

Added value: +[
+  "upstream_unavailable"
+]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "author_id",
+      "name",
+      "photo_ids",
+      "remote_ids"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "author_id",
-  "name",
-  "photo_ids",
-  "remote_ids"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "author_id",
+      "works"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: Author ID does not exist on Open Library. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "total",
-  "author_id",
-  "works"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "url",
+      "note"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `invalid_identifier`: The identifier contains path separators, \"..\", or control characters, or does not match the format its id_type expects. `invalid_target`: The id_type is not valid for the target — an author photo cannot be resolved by ISBN. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "invalid_identifier",
+            "invalid_target"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "url",
-  "note"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "editions",
+      "unresolved"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No identifier in the batch resolved to an edition. `invalid_identifier`: Every identifier in the batch is malformed for the specified id_type. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found",
+            "invalid_identifier"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "editions",
-  "unresolved"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "work_id",
+      "editions"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "total",
-  "work_id",
-  "editions"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "subject_name",
+      "subject_key",
+      "work_count",
+      "works"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode.",
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "subject_name",
-  "subject_key",
-  "work_count",
-  "works"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "work_id",
+      "title",
+      "subjects",
+      "subject_places",
+      "subject_times",
+      "subject_people",
+      "cover_ids",
+      "author_ids"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: Work ID does not exist on Open Library. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "work_id",
-  "title",
-  "subjects",
-  "subject_places",
-  "subject_times",
-  "subject_people",
-  "cover_ids",
-  "author_ids"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "offset",
+      "authors"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode.",
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "total",
-  "offset",
-  "authors"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "offset",
+      "works"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `unknown_language_code`: A 2-letter language value has no MARC equivalent, so no filter could be applied. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "unknown_language_code"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "total",
-  "offset",
-  "works"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "total",
+      "offset",
+      "matches"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode.",
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "total",
-  "offset",
-  "matches"
-]

Added value: +{
+  "description": "Set when the requested author ID was merged into a different canonical ID.",
+  "type": "string"
+}

Added value: +{
+  "description": "Set when the requested author ID was merged into a different canonical ID.",
+  "type": "string"
+}

Previous value: -"The identifier value. For \"id\": numeric cover ID from work/edition data. For \"isbn\": 10 or 13 digits, hyphens stripped. For \"olid\": edition OLID (OL…M) or author OLID (OL…A) when target is \"author\"."New value: +"The identifier value, validated against id_type before the URL is built. For \"id\": a numeric cover or photo ID from work/edition/author data. For \"isbn\": 10 or 13 digits, hyphens optional. For \"olid\": an edition OLID (OL…M) for target \"book\", an author OLID (OL…A) for target \"author\"."

Previous value: -"Identifier type. \"isbn\" handles both ISBN-10 and ISBN-13. \"olid\" is the native Open Library edition ID (OL…M)."New value: +"Identifier type shared by every entry in identifiers. \"isbn\" handles both ISBN-10 and ISBN-13. \"olid\" is the native Open Library edition ID (OL…M). Mixing types within one call is not supported — issue one call per type."

Removed value: -{
-  "description": "The identifier value. For ISBN: 10 or 13 digits, hyphens stripped. For OCLC: numeric string. For LCCN: string as-is. For OLID: Open Library edition ID (e.g., OL7353617M).",
-  "type": "string"
-}

Added value: +{
+  "description": "Identifiers to resolve, 1–50, all of the type named by id_type. Resolved editions come back in request order.",
+  "items": {
+    "description": "One identifier value. For ISBN: 10 or 13 digits, hyphens optional. For OCLC: numeric string. For LCCN: string as-is. For OLID: Open Library edition ID (e.g., OL7353617M).",
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -[
-  "identifier",
-  "id_type"
-]New value: +[
+  "identifiers",
+  "id_type"
+]

Removed value: -{
-  "description": "Authors credited for this edition. Empty only when neither the edition nor its parent work records an author.",
-  "items": {
-    "additionalProperties": false,
-    "description": "An author contributor for this edition.",
-    "properties": {
-      "author_id": {
-        "description": "Open Library Author ID (OL…A). Use openlibrary_get_author for bio and details.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Author display name.",
-        "type": "string"
-      },
-      "source": {
-        "description": "\"edition\" = the attribution is recorded on this edition record. \"work\" = the edition records no authors of its own and this credit comes from the parent work, which covers every edition of the same text.",
-        "enum": [
-          "edition",
-          "work"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "name",
-      "source"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Numeric cover IDs for openlibrary_get_cover_url.",
-  "items": {
-    "type": "number"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Edition description. Absent when not provided.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Internet Archive URL for reading/borrowing. Present when an IA item exists.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Open Library Edition ID (OL…M).",
-  "type": "string"
-}

Added value: +{
+  "description": "Editions that resolved, in request order. Shorter than identifiers when any entry missed.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A resolved edition record.",
+    "properties": {
+      "authors": {
+        "description": "Authors credited for this edition. Empty only when neither the edition nor its parent work records an author.",
+        "items": {
+          "additionalProperties": false,
+          "description": "An author contributor for this edition.",
+          "properties": {
+            "author_id": {
+              "description": "Open Library Author ID (OL…A). Use openlibrary_get_author for bio and details.",
+              "type": "string"
+            },
+            "name": {
+              "description": "Author display name.",
+              "type": "string"
+            },
+            "source": {
+              "description": "\"edition\" = the attribution is recorded on this edition record. \"work\" = the edition records no authors of its own and this credit comes from the parent work, which covers every edition of the same text.",
+              "enum": [
+                "edition",
+                "work"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "source"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "cover_ids": {
+        "description": "Numeric cover IDs for openlibrary_get_cover_url.",
+        "items": {
+          "type": "number"
+        },
+        "type": "array"
+      },
+      "description": {
+        "description": "Edition description. Absent when not provided.",
+        "type": "string"
+      },
+      "ebook_url": {
+        "description": "Internet Archive URL for reading/borrowing. Present when an IA item exists.",
+        "type": "string"
+      },
+      "edition_id": {
+        "description": "Open Library Edition ID (OL…M).",
+        "type": "string"
+      },
+      "isbn_10": {
+        "description": "ISBN-10 identifiers.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "isbn_13": {
+        "description": "ISBN-13 identifiers.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "language": {
+        "description": "3-letter ISO language code (e.g., \"eng\"). Absent when not recorded.",
+        "type": "string"
+      },
+      "lc_classifications": {
+        "description": "Library of Congress call numbers (e.g., \"TL685.7 .M366 2008\") — shelving classifications describing the subject, not identifiers. Not usable as a lookup value anywhere.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "lccn": {
+        "description": "Library of Congress Control Numbers (e.g., \"2008478952\") — lookupable identifiers; each one resolves this edition back through this tool with id_type \"lccn\".",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "oclc": {
+        "description": "OCLC/WorldCat numbers.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "page_count": {
+        "description": "Page count. Absent when not recorded.",
+        "type": "number"
+      },
+      "publish_date": {
+        "description": "Publication date string. Absent when not recorded.",
+        "type": "string"
+      },
+      "publishers": {
+        "description": "Publisher names.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "title": {
+        "description": "Edition title.",
+        "type": "string"
+      },
+      "work_id": {
+        "description": "Parent Work ID (OL…W). Use openlibrary_get_work for work-level metadata.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "edition_id",
+      "title",
+      "authors",
+      "publishers",
+      "isbn_10",
+      "isbn_13",
+      "oclc",
+      "lccn",
+      "lc_classifications",
+      "cover_ids"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "ISBN-10 identifiers.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "ISBN-13 identifiers.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "3-letter ISO language code (e.g., \"eng\"). Absent when not recorded.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Library of Congress call numbers (e.g., \"TL685.7 .M366 2008\") — shelving classifications describing the subject, not identifiers. Not usable as a lookup value anywhere.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Library of Congress Control Numbers (e.g., \"2008478952\") — lookupable identifiers; each one resolves this edition back through this tool with id_type \"lccn\".",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "OCLC/WorldCat numbers.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Page count. Absent when not recorded.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Publication date string. Absent when not recorded.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Publisher names.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Edition title.",
-  "type": "string"
-}

Added value: +{
+  "description": "Identifiers that produced no edition. Empty when every identifier resolved; never overlaps editions.",
+  "items": {
+    "additionalProperties": false,
+    "description": "An identifier that produced no edition.",
+    "properties": {
+      "identifier": {
+        "description": "The identifier as supplied, echoed so it can be matched to the request.",
+        "type": "string"
+      },
+      "reason": {
+        "description": "\"invalid_identifier\" = the value cannot be this id_type and was never sent upstream. \"not_found\" = well-formed, but Open Library holds no edition under it.",
+        "enum": [
+          "not_found",
+          "invalid_identifier"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "identifier",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "Parent Work ID (OL…W). Use openlibrary_get_work for work-level metadata.",
-  "type": "string"
-}

Previous value: -[
-  "edition_id",
-  "title",
-  "authors",
-  "publishers",
-  "isbn_10",
-  "isbn_13",
-  "oclc",
-  "lccn",
-  "lc_classifications",
-  "cover_ids"
-]New value: +[
+  "editions",
+  "unresolved"
+]

Previous value: -"Subject name. Spaces are converted to underscores internally (e.g., \"science fiction\" → \"science_fiction\"). Use lowercase for best results."New value: +"Subject name. Normalized before lookup — lowercased with spaces converted to underscores (e.g., \"Science Fiction\" → \"science_fiction\") — so varying case or spacing does not change the result."

Previous value: -"Recovery guidance when no authors match — echoes the query and suggests alternatives. Absent when results are found."New value: +"Guidance when the page is empty (how to vary a name that matched nothing, or which offset to retry when offset ran past the end) or when the text output capped a per-author list. Absent when neither applies."

Added value: +{
+  "description": "Zero-based offset of the first returned result — echoes the requested offset, so an empty page still records the offset that produced it.",
+  "type": "number"
+}

Previous value: -"Total matching authors across all pages. Absent when results are empty."New value: +"Total matching authors across all pages — the upstream match count, reported even when this page is empty because offset ran past the end."

Previous value: -[
-  "total",
-  "authors"
-]New value: +[
+  "total",
+  "offset",
+  "authors"
+]

Previous value: -"Recovery guidance when results are empty — echoes the search criteria and suggests how to broaden. Absent when results are found."New value: +"Guidance when the page is empty (how to broaden a query that matched nothing, or which offset to retry when offset ran past the end) or when the text output capped a per-work list. Absent when neither applies."

Previous value: -"Total matching works across all pages. Absent when results are empty."New value: +"Total matching works across all pages — the upstream match count, reported even when this page is empty because offset ran past the end."

Previous value: -"Up to 5 subject tags. Absent when no subjects are tagged."New value: +"Every subject tag the search index returned for this work. The text output caps the rendered list; this array is complete. Absent when no subjects are tagged. For the work record's own curated subject lists (places, times, people), use openlibrary_get_work."

Previous value: -"Authors of this edition."New value: +"Authors credited for this edition. Empty only when neither the edition nor its parent work records an author."

Added value: +{
+  "description": "\"edition\" = the attribution is recorded on this edition record. \"work\" = the edition records no authors of its own and this credit comes from the parent work, which covers every edition of the same text.",
+  "enum": [
+    "edition",
+    "work"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "name"
-]New value: +[
+  "name",
+  "source"
+]

Added value: +{
+  "description": "Library of Congress call numbers (e.g., \"TL685.7 .M366 2008\") — shelving classifications describing the subject, not identifiers. Not usable as a lookup value anywhere.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Library of Congress Control Numbers."New value: +"Library of Congress Control Numbers (e.g., \"2008478952\") — lookupable identifiers; each one resolves this edition back through this tool with id_type \"lccn\"."

Previous value: -[
-  "edition_id",
-  "title",
-  "authors",
-  "publishers",
-  "isbn_10",
-  "isbn_13",
-  "oclc",
-  "lccn",
-  "cover_ids"
-]New value: +[
+  "edition_id",
+  "title",
+  "authors",
+  "publishers",
+  "isbn_10",
+  "isbn_13",
+  "oclc",
+  "lccn",
+  "lc_classifications",
+  "cover_ids"
+]

Previous value: -"Two-letter ISO 639-1 language code (e.g., \"en\", \"fr\"). Influences but does not exclude results; use language:fr in query to hard-filter."New value: +"Restrict results to one language. Takes a 3-letter MARC code (e.g., \"eng\", \"fre\", \"ger\", \"chi\") — the same vocabulary openlibrary_get_edition and openlibrary_get_editions return. A 2-letter ISO 639-1 code (e.g., \"en\", \"fr\") is accepted and translated to its MARC equivalent; an unrecognized 2-letter code is rejected rather than silently ignored. The equivalent in-query form is language:eng."

Added value: +"^[A-Za-z]{2,3}$"

Previous value: -"\"public\" = freely readable. \"borrowable\" = borrow on Internet Archive. \"printdisabled\" = access for print-disabled users. \"no_ebook\" = no digital version."New value: +"\"public\" = freely readable. \"borrowable\" = borrow on Internet Archive. \"printdisabled\" = access for print-disabled users. \"no_ebook\" = no digital version. \"unclassified\" = a digital copy may exist but its access tier is not recorded."

Previous value: -[
-  "no_ebook",
-  "printdisabled",
-  "borrowable",
-  "public"
-]New value: +[
+  "no_ebook",
+  "unclassified",
+  "printdisabled",
+  "borrowable",
+  "public"
+]

Added value: +{
+  "description": "Disclosure when the text output caps a long list — names the omitted count and points to the complete array in structuredContent. Absent when nothing was capped.",
+  "type": "string"
+}

Added value: +{
+  "description": "Total works by this author across all pages.",
+  "type": "number"
+}

Added value: +{
+  "description": "Total editions for this work across all pages.",
+  "type": "number"
+}

Added value: +{
+  "description": "Total works tagged with this subject across all pages.",
+  "type": "number"
+}

Added value: +{
+  "description": "Total matching authors across all pages. Absent when results are empty.",
+  "type": "number"
+}

Added value: +{
+  "description": "Total matching works across all pages. Absent when results are empty.",
+  "type": "number"
+}