Search records with filters
search_recordsSearch the archive with filters for collection, shelf (sub_collection), kind (media_type: document, image, video or audio), HABS/HAER survey number, entity, content type, island and year. Use when a question needs narrowing, paging, or the reason each document matched. Searches the full extracted text of the archive's documents, plus their catalogue records. Filters use the same vocabulary as the website's own facets. Every result carries a tier, a plain reason and the search terms it actually matched; there is no numeric relevance score. The tiers: exact = every term, found in the document's title or issuing entity (likely about the subject); strong = every term, in the text only (it mentions them); possible = at least half the terms; weak = fewer. When no document contains all the terms, results contain some of them and the response says so, and 'matched' lists which. Not covered: the archive's newspapers (the St. Croix Avis, The West End News, Home Journal and the St. Croix Tribune) and the Danish West Indies papers it opens for search, which are on its separate newspaper connector (the 2026 Virgin Islands Code is here, in search_code and get_code_section); and anything the archive has not published. Withheld and withdrawn documents are absent, not hidden.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_records"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Default 10, maximum 50. | |
| query | Yes | Plain language is fine. Quote a phrase to require it intact. | |
| entity | No | The issuing or subject body, exactly as recorded, e.g. "Water and Power Authority". Recorded on only part of the archive; archive_stats gives the share. | |
| island | No | e.g. "St. Croix", "St. Thomas", "St. John" | |
| offset | No | Results to skip, for paging. Results are ranked within the best 120 documents. | |
| survey | No | A Historic American Buildings Survey or Engineering Record number, e.g. "HABS VI-3" or "HAER VI-2-A": every photograph, drawing and written record of that survey. A search query is still needed; the building name works. | |
| year_to | No | Latest year, inclusive. The year_from note on dates applies. | |
| year_from | No | Earliest year, inclusive. Filters on the date the archive recorded, whose provenance varies by source: for most documents it is the date on the document, for some it is when the source posted the file. A year range can therefore miss a document executed in one year and posted the next, so it narrows rather than guarantees. | |
| collection | No | e.g. "Courts", "Audits & Oversight" | |
| media_type | No | The kind of item: "image" (photographs, drawings, maps, plates), "video" (film), "audio" (recordings) or "document". | |
| content_type | No | The kind of document, exactly as recorded, e.g. "government-audit". An unknown value returns the nearest values that exist. | |
| sub_collection | No | A shelf within a collection, exactly as recorded, e.g. "HABS/HAER Building Surveys" or "Internet Archive (V.I. texts)". list_collections gives every shelf. |