Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Keyword search across OCR text and newspaper metadata."
},
"date_start": {
"description": "Start of the date filter, inclusive: an integer year (e.g., 1900) or a \"YYYY\", \"YYYY-MM\", or \"YYYY-MM-DD\" string (e.g., \"1912-04-15\"); month and day may be one or two digits. A year or month starts on its first day. Omit for no lower bound.",
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "A year, e.g., 1912."
},
{
"type": "string",
"pattern": "^(\\d{4})(?:-(\\d{1,2})(?:-(\\d{1,2}))?)?$",
"description": "A date: \"YYYY\", \"YYYY-MM\", or \"YYYY-MM-DD\", e.g., \"1912-04-16\"."
},
{
"type": "string",
"const": ""
}
]
},
"date_end": {
"description": "End of the date filter, inclusive, in the same forms as date_start (e.g., 1920 or \"1912-04-16\"). A year or month ends on its last day, so \"1912-04\" runs through April 30. Omit to run through the current year.",
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "A year, e.g., 1912."
},
{
"type": "string",
"pattern": "^(\\d{4})(?:-(\\d{1,2})(?:-(\\d{1,2}))?)?$",
"description": "A date: \"YYYY\", \"YYYY-MM\", or \"YYYY-MM-DD\", e.g., \"1912-04-16\"."
},
{
"type": "string",
"const": ""
}
]
},
"sort": {
"default": "relevance",
"description": "Result order: relevance (default), date (oldest first), or date_desc (newest first). Uses LOC catalog dates and upstream ordering.",
"type": "string",
"enum": [
"relevance",
"date",
"date_desc"
]
},
"state": {
"description": "Filter by LOC's State/Province facet: a full indexed name (e.g., \"oklahoma\", \"piedmont\") or a supported US postal code (e.g., \"OK\", \"NY\"), case-insensitive. Use \"district of columbia\" (or \"DC\") for Washington, D.C.; \"washington\" means Washington state. City and county names match nothing. state_facets (include_facets) lists the top states for a search.",
"type": "string"
},
"newspaper_title": {
"description": "Filter to one newspaper. Pass the newspaper_title value of a libofcongress_search_newspapers result exactly (case-insensitive), e.g., \"new-york tribune (new york [n.y.]) 1866-1924\" β the full catalog title with place and run. A shortened title such as \"New-York Tribune\" matches nothing. newspaper_title_facets (include_facets) lists the top titles for a search in this form.",
"type": "string"
},
"language": {
"description": "Filter by page language, named as LOC indexes it (e.g., \"german\", \"english\", \"spanish\"), case-insensitive. A bilingual page matches each of its languages. language_facets (include_facets) lists the languages a search covers.",
"type": "string"
},
"include_facets": {
"default": false,
"description": "Also return newspaper_title_facets, state_facets, and language_facets: LOC's top newspaper titles, states, and languages across every matching page, with counts β values the newspaper_title, state, and language filters accept unchanged. Default false: LOC's facet block is large, so request facets when you need filter values to narrow by.",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Results per page. Default 25. A page holds at most 100 results: a larger limit (up to 1000) is served as a 100-result page, and page then counts 100-result pages.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"page": {
"default": 1,
"description": "1-indexed page number for paginating results.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}