addedInput schema / properties / match
Added value: +{
+ "description": "Return the passages around these terms instead of the whole page — pass the query you gave libofcongress_search_newspapers (e.g., titanic, or \"the titanic\" iceberg); the q= in a search result url is not read as match. Words separated by spaces are separate terms, any of which matches; a double-quoted span is one phrase. Each matches case-insensitively as literal text, with line breaks read as spaces; OCR misreads are not repaired. When set, ocr_text is empty, matches holds up to 10 passages of about 300 characters either side of each occurrence — when they need more, occurrences of the rarest terms come first, so a common word only fills the slots left — and match_count counts every occurrence. Omit match for the whole page. Up to 200 characters; blank is ignored.",
+ "maxLength": 200,
+ "type": "string"
+}
addedOutput schema / properties / item_id
Added value: +{
+ "description": "ID of the item this page belongs to: the newspaper issue (e.g., \"sn83030214/1912-04-16/ed-1\"), book, or manuscript volume (e.g., \"mm77093930\"). Pass it to libofcongress_get_item to list every page of the item, each with its page_url and has_text — for an article continued on a later page, or the next page of a book. Absent when LOC names no item.",
+ "type": "string"
+}
addedOutput schema / properties / item_title
Added value: +{
+ "description": "Title of the item this page belongs to, on every page type: the book or manuscript title, or for a newspaper page the issue title with place and date (e.g., \"New-York tribune (New York [N.Y.]), April 16, 1912\"). Absent when LOC gives none.",
+ "type": "string"
+}
addedOutput schema / properties / match_count
Added value: +{
+ "description": "Present only when match is set: occurrences of every match term on the page, including those beyond the passages returned. 0 when nothing matched or the page has no text.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+}
addedOutput schema / properties / matches
Added value: +{
+ "description": "Present only when match is set: passages of the page text around the occurrences of the match terms, in page order — about 300 characters either side of each occurrence, overlapping passages merged up to 1,200 characters, never overlapping, at most 10, chosen around the rarest terms first when more would be needed. Empty when nothing matched or the page has no text.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
changedOutput schema / properties / notice / description
Previous value: -"Set when ocr_available is true but ocr_text is empty, saying why: the text service did not answer this call (retry), its answer could not be read as text (retrying will not help), or the page's text is empty. Distinguishes these from a genuinely image-only page (where ocr_available is false). Absent when text was returned or the page has none."New value: +"Set when ocr_available is true but the page's text came back empty, saying why: the text service did not answer this call (retry), its answer could not be read as text (retrying will not help), or the page's text is empty — a blank page, including one LOC sends as the placeholder [NO TEXT AVAILABLE FOR THIS PAGE]. Distinguishes these from a genuinely image-only page (where ocr_available is false), which carries no notice. With match set on a page that has text, set instead when nothing matched or when some occurrences fall outside the passages returned — those are read on the whole page, by calling again without match. Absent otherwise."
changedOutput schema / properties / ocr_available / description
Previous value: -"True when LOC holds OCR or transcribed text for this page. False for image-only pages where no text has been produced."New value: +"True when LOC lists OCR or transcribed text for this page, even if the text it returns is empty (see notice). False for image-only pages where no text has been produced."
changedOutput schema / properties / ocr_text / description
Previous value: -"Full plain text of this page: OCR, or for some manuscripts a volunteer transcription. Empty string when ocr_available is false, or when the text could not be retrieved (see notice). May contain fragmented words, line-break artifacts, and misspellings inherent to historical OCR — do not attempt to repair."New value: +"Full plain text of this page: OCR, or for some manuscripts a volunteer transcription. Empty string when match is set (read matches instead), when ocr_available is false, or when the page is blank or its text could not be retrieved (see notice). May contain fragmented words, line-break artifacts, and misspellings inherent to historical OCR — do not attempt to repair."