{"openapi":"3.1.0","info":{"title":"National Library of Norway — Catalog Search API","description":"A REST API providing search and retrieval of catalog items from the National Library of Norway's collections.\n\n## What You Can Search\nThe API provides access to the National Library's catalog metadata and digitized content, including:\n- **Books and periodicals** — monographs, newspapers, journals\n- **Music** — albums, tracks, sheet music\n- **Maps, photos, and posters** — visual materials\n- **Film and broadcasting** — audiovisual resources\n- **Manuscripts and letters** — archival materials\n\n## API Capabilities\n- **Full-text search** — search in metadata and OCR-extracted text content\n- **Field-restricted queries** — target specific metadata fields (title, creator, subject, etc.)\n- **Filtering** — narrow results by media type, language, date range, digital availability, and more\n- **Sorting** — sort by date, title, or relevance\n- **Aggregations/facets** — get counts per category for faceted navigation\n- **Pagination** — navigate large result sets with configurable page size\n- **Content fragments** — retrieve highlighted text snippets matching your query\n- **HATEOAS** — hypermedia links (HAL format) for discoverability\n\n## Main Endpoints\n| Endpoint | Purpose |\n|----------|---------|\n| `GET /catalog/v1/items` | **Primary search endpoint** — search and paginate catalog items |\n| `GET /catalog/v1/items/{id}` | Retrieve a single item with full metadata |\n| `GET /catalog/v1/search` | MultiSearch — returns result sets grouped by media type |\n| `GET /catalog/v1/aggregations` | Aggregation-only queries for facet counts |\n| `GET /catalog/v1/musicsearch` | Specialized music search (albums + tracks) |\n\n## Getting Started\nA simple search for items by Hamsun:\n```\nGET /catalog/v1/items?q=hamsun&size=10\n```\nFilter to only digitally available newspapers:\n```\nGET /catalog/v1/items?q=*&filter=mediatype:aviser&filter=digital:Ja\n```\n","contact":{"name":"National Library of Norway","url":"https://www.nb.no/","email":"nasa@nb.no"},"version":"1.0"},"servers":[{"url":"https://api.nb.no","description":"Generated server url"}],"tags":[{"name":"items","description":"Primary search and item retrieval API. Use this endpoint for searching the catalog and fetching individual items with full metadata."},{"name":"search","description":"MultiSearch API — executes a single query across multiple media types and returns separate result sets per media type in one response."},{"name":"aggregations","description":"Aggregation-only queries. Returns facet counts without item results, useful for building filter UIs."},{"name":"musicsearch","description":"Specialized music search returning results grouped by album and tracks."}],"paths":{"/catalog/v1/search":{"get":{"tags":["search"],"summary":"MultiSearch — search across media types","description":"Executes a single search query across multiple media types and returns separate result sets per media type in one response. Useful for building overview pages that show results from books, newspapers, photos, etc. simultaneously. For searching within a single result set, use GET /catalog/v1/items instead.","operationId":"superSearch","parameters":[{"name":"mediaTypeOrder","in":"query","description":"In which order the mediatypes are shown","required":false,"schema":{"type":"list"},"example":"bøker,aviser,bilder"},{"name":"mediaTypeSize","in":"query","description":"Number of mediatypes to show","required":false,"schema":{"type":"list"},"example":3},{"name":"q","in":"query","description":"Search query string. Supports free text and field-restricted queries. Field queries use the syntax field:value and can be combined with free text. <br/>For better performance, use the 'filter' parameter instead of field-restricted queries in 'q'. <br/>Supported query fields: api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace, collection, contentclasses, county, municipality, ddc, description, digital, freetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype, name, namecreators, nameauthor, oaiid, origininfoplace, publisher, relationtype, sesamid, series, seriestitle, set, subject, subjectgeographic, subjectname, subjecttopic, targetaudience, title, title_alternative, year, urn","required":true,"schema":{"type":"string"},"example":"hamsun"},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported. <br/>Allowable values: date, title, otherid, firstDigitalContentTime","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aggs","in":"query","description":"Aggregations, format: field(:count:order). <br/>Default size: 50, default order: countdesc. Allowable order values: countasc, countdesc, termasc, termdesc <br/>Allowable values:  bibliography, county, municipality, ddc1, ddc2, ddc3, genre, languages, literaryform, mediatype, relationType, series, set, targetaudience, year","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"searchType","in":"query","description":"Search in fulltext/ocr, metadata or both (default)","required":false,"schema":{"type":"string","default":"FULL_TEXT_SEARCH","enum":["TEXT_SEARCH","FIELD_RESTRICTED_SEARCH","FULL_TEXT_SEARCH"]}},{"name":"digitalAccessibleOnly","in":"query","description":"Search only in the material that you have the rights to look at","required":false,"schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"Expand metadata or relatedItems","required":false,"schema":{"type":"string","enum":["metadata","relatedItems"]}},{"name":"filter","in":"query","description":"Filter query to narrow search results. Format: field:value. Multiple filters are supported. <br/><b>Standard filters</b>: field:value passed as search engine query_string, e.g. mediatype:aviser, languages:nob, digital:Ja <br/>Supported query fields: <br/>collection, contentclasses, county, municipality, ddc, description, digital,\nfreetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype,\nname, namecreators, nameauthor, oaiid, origininfoplace, publisher,\nrelationtype, sesamid, series, seriestitle, set, subject, subjectgeographic,\nsubjectname, subjecttopic, targetaudience, title, title_alternative, year, urn <br/><b>API text filters</b> (text search with accent folding): <br/>Supported query fields: <br/>api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace <br/><b>Date range filters</b>: date:[yyyyMMdd TO yyyyMMdd], firstDigitalContentTime:[yyyyMMdd TO yyyyMMdd], lastModified:[yyyyMMdd TO yyyyMMdd]","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aq","in":"query","description":"Aggregations query, filter on aggregated values, ex.: county:Nordland","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"snippets","in":"query","description":"Snippets/fragments, specified per material type, ex.: aviser","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32"},"example":2},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32"},"example":500},{"name":"random","in":"query","description":"Arbitrary ranking of hits","required":false,"schema":{"type":"boolean"}},{"name":"profile","in":"query","description":"Application Profile","required":false,"schema":{"type":"string","enum":["wwwnbno","nbdigital","beta","dfb","frigg","valhall","statfjord","statsmaktene","draugen","ekofisk","equinor50","industriminne"],"example":"wwwnbno"}},{"name":"pageable","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Pageable"}}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SuperItemSearchEntityModel"}}}}}}},"/catalog/v1/musicsearch":{"get":{"tags":["musicsearch"],"summary":"Search music catalog","description":"Specialized music search that returns results grouped by album and tracks. Designed for music discovery use cases.","operationId":"musicSearch","parameters":[{"name":"q","in":"query","description":"Search query string. Supports free text and field-restricted queries. Field queries use the syntax field:value and can be combined with free text. <br/>For better performance, use the 'filter' parameter instead of field-restricted queries in 'q'. <br/>Supported query fields: api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace, collection, contentclasses, county, municipality, ddc, description, digital, freetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype, name, namecreators, nameauthor, oaiid, origininfoplace, publisher, relationtype, sesamid, series, seriestitle, set, subject, subjectgeographic, subjectname, subjecttopic, targetaudience, title, title_alternative, year, urn","required":true,"schema":{"type":"string"},"example":"hamsun"},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported. <br/>Allowable values: date, title, otherid, firstDigitalContentTime","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aggs","in":"query","description":"Aggregations, format: field(:count:order). <br/>Default size: 50, default order: countdesc. Allowable order values: countasc, countdesc, termasc, termdesc <br/>Allowable values:  bibliography, county, municipality, ddc1, ddc2, ddc3, genre, languages, literaryform, mediatype, relationType, series, set, targetaudience, year","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"searchType","in":"query","description":"Search in fulltext/ocr, metadata or both (default)","required":false,"schema":{"type":"string","default":"FULL_TEXT_SEARCH","enum":["TEXT_SEARCH","FIELD_RESTRICTED_SEARCH","FULL_TEXT_SEARCH"]}},{"name":"digitalAccessibleOnly","in":"query","description":"Search only in the material that you have the rights to look at","required":false,"schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"Expand metadata or relatedItems","required":false,"schema":{"type":"string","enum":["metadata","relatedItems"]}},{"name":"filter","in":"query","description":"Filter query to narrow search results. Format: field:value. Multiple filters are supported. <br/><b>Standard filters</b>: field:value passed as search engine query_string, e.g. mediatype:aviser, languages:nob, digital:Ja <br/>Supported query fields: <br/>collection, contentclasses, county, municipality, ddc, description, digital,\nfreetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype,\nname, namecreators, nameauthor, oaiid, origininfoplace, publisher,\nrelationtype, sesamid, series, seriestitle, set, subject, subjectgeographic,\nsubjectname, subjecttopic, targetaudience, title, title_alternative, year, urn <br/><b>API text filters</b> (text search with accent folding): <br/>Supported query fields: <br/>api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace <br/><b>Date range filters</b>: date:[yyyyMMdd TO yyyyMMdd], firstDigitalContentTime:[yyyyMMdd TO yyyyMMdd], lastModified:[yyyyMMdd TO yyyyMMdd]","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aq","in":"query","description":"Aggregations query, filter on aggregated values, ex.: county:Nordland","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"snippets","in":"query","description":"Snippets/fragments, specified per material type, ex.: aviser","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32"},"example":2},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32"},"example":500},{"name":"random","in":"query","description":"Arbitrary ranking of hits","required":false,"schema":{"type":"boolean"}},{"name":"profile","in":"query","description":"Application Profile","required":false,"schema":{"type":"string","enum":["wwwnbno","nbdigital","beta","dfb","frigg","valhall","statfjord","statsmaktene","draugen","ekofisk","equinor50","industriminne"],"example":"wwwnbno"}},{"name":"pageable","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Pageable"}}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MusicItemSearchEntityModel"}}}}}}},"/catalog/v1/items":{"get":{"tags":["items"],"summary":"Search catalog items","description":"Primary search endpoint for the National Library catalog. Supports full-text search in metadata and OCR content, field-restricted queries, filtering, sorting, aggregations, and pagination. Returns items in HAL format with hypermedia links.","operationId":"search","parameters":[{"name":"q","in":"query","description":"Search query string. Supports free text and field-restricted queries. Field queries use the syntax field:value and can be combined with free text. <br/>For better performance, use the 'filter' parameter instead of field-restricted queries in 'q'. <br/>Supported query fields: api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace, collection, contentclasses, county, municipality, ddc, description, digital, freetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype, name, namecreators, nameauthor, oaiid, origininfoplace, publisher, relationtype, sesamid, series, seriestitle, set, subject, subjectgeographic, subjectname, subjecttopic, targetaudience, title, title_alternative, year, urn","required":true,"schema":{"type":"string"},"example":"hamsun"},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported. <br/>Allowable values: date, title, otherid, firstDigitalContentTime","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aggs","in":"query","description":"Aggregations, format: field(:count:order). <br/>Default size: 50, default order: countdesc. Allowable order values: countasc, countdesc, termasc, termdesc <br/>Allowable values:  bibliography, county, municipality, ddc1, ddc2, ddc3, genre, languages, literaryform, mediatype, relationType, series, set, targetaudience, year","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"searchType","in":"query","description":"Search in fulltext/ocr, metadata or both (default)","required":false,"schema":{"type":"string","default":"FULL_TEXT_SEARCH","enum":["TEXT_SEARCH","FIELD_RESTRICTED_SEARCH","FULL_TEXT_SEARCH"]}},{"name":"digitalAccessibleOnly","in":"query","description":"Search only in the material that you have the rights to look at","required":false,"schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"Expand metadata or relatedItems","required":false,"schema":{"type":"string","enum":["metadata","relatedItems"]}},{"name":"filter","in":"query","description":"Filter query to narrow search results. Format: field:value. Multiple filters are supported. <br/><b>Standard filters</b>: field:value passed as search engine query_string, e.g. mediatype:aviser, languages:nob, digital:Ja <br/>Supported query fields: <br/>collection, contentclasses, county, municipality, ddc, description, digital,\nfreetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype,\nname, namecreators, nameauthor, oaiid, origininfoplace, publisher,\nrelationtype, sesamid, series, seriestitle, set, subject, subjectgeographic,\nsubjectname, subjecttopic, targetaudience, title, title_alternative, year, urn <br/><b>API text filters</b> (text search with accent folding): <br/>Supported query fields: <br/>api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace <br/><b>Date range filters</b>: date:[yyyyMMdd TO yyyyMMdd], firstDigitalContentTime:[yyyyMMdd TO yyyyMMdd], lastModified:[yyyyMMdd TO yyyyMMdd]","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aq","in":"query","description":"Aggregations query, filter on aggregated values, ex.: county:Nordland","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"snippets","in":"query","description":"Snippets/fragments, specified per material type, ex.: aviser","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32"},"example":2},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32"},"example":500},{"name":"random","in":"query","description":"Arbitrary ranking of hits","required":false,"schema":{"type":"boolean"}},{"name":"profile","in":"query","description":"Application Profile","required":false,"schema":{"type":"string","enum":["wwwnbno","nbdigital","beta","dfb","frigg","valhall","statfjord","statsmaktene","draugen","ekofisk","equinor50","industriminne"],"example":"wwwnbno"}},{"name":"page","in":"query","description":"Zero-based page index (0..N)","required":false,"schema":{"type":"integer","default":0,"minimum":0}},{"name":"size","in":"query","description":"The size of the page to be returned","required":false,"schema":{"type":"integer","default":10,"minimum":1}}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ItemSearchEntityModel"}}}}}}},"/catalog/v1/items/{id}/relatedItems":{"get":{"tags":["items"],"summary":"Get related items","description":"Retrieve items related to a given catalog item (e.g., other editions, volumes in a series, or associated resources).","operationId":"getRelatedItems","parameters":[{"name":"id","in":"path","description":"Sesamid or URN","required":true,"schema":{"type":"string"},"example":"d66ab3b3a1b6885d261509f0b7d24ec7"}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RelatedItemEntityModel"}}}}}}},"/catalog/v1/items/{id}/contentfragments":{"get":{"tags":["items"],"summary":"Search in item content","description":"Search within the full-text (OCR) content of a specific item and retrieve highlighted text fragments matching the query.","operationId":"contentFragments","parameters":[{"name":"id","in":"path","description":"Sesamid or URN","required":true,"schema":{"type":"string"},"example":"d66ab3b3a1b6885d261509f0b7d24ec7"},{"name":"q","in":"query","description":"Querystring","required":true,"schema":{"type":"string"},"example":"dupp"},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32","default":5},"example":3},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32","default":500},"example":300}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ContentFragmentsEntityModel"}}}}}}},"/catalog/v1/items/{id}":{"get":{"tags":["items"],"summary":"Get a specific catalog item","description":"Retrieve a single catalog item by its Sesam ID or URN. Returns full metadata including access information, related items, and HATEOAS links. Use the 'fields' parameter to limit the response, or 'expand=false' to get lightweight index-based metadata.","operationId":"getItem","parameters":[{"name":"id","in":"path","description":"Sesamid or URN","required":true,"schema":{"type":"string"},"example":"d66ab3b3a1b6885d261509f0b7d24ec7"},{"name":"fields","in":"query","description":"Fields returned. All fields are returned by default.","required":false,"schema":{"type":"string","enum":["_links","accessInfo","metadata"],"example":"metadata"}},{"name":"expand","in":"query","description":"Metadata and relatedItems are by default expanded (rich metadata). Use 'false' to get index-based metadata.","required":false,"schema":{"type":"string","default":"metadata"},"example":false}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ItemEntityModel"}}}}}}},"/catalog/v1/items/searchafter":{"get":{"tags":["items"],"summary":"Get next batch of search results","description":"Cursor-based pagination using search_after. Use this to efficiently paginate beyond the standard page limit by providing the searchAfterId from a previous response.","operationId":"searchAfter","parameters":[{"name":"q","in":"query","description":"Search query string. Supports free text and field-restricted queries. Field queries use the syntax field:value and can be combined with free text. <br/>For better performance, use the 'filter' parameter instead of field-restricted queries in 'q'. <br/>Supported query fields: api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace, collection, contentclasses, county, municipality, ddc, description, digital, freetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype, name, namecreators, nameauthor, oaiid, origininfoplace, publisher, relationtype, sesamid, series, seriestitle, set, subject, subjectgeographic, subjectname, subjecttopic, targetaudience, title, title_alternative, year, urn","required":true,"schema":{"type":"string"},"example":"hamsun"},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported. <br/>Allowable values: date, title, otherid, firstDigitalContentTime","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aggs","in":"query","description":"Aggregations, format: field(:count:order). <br/>Default size: 50, default order: countdesc. Allowable order values: countasc, countdesc, termasc, termdesc <br/>Allowable values:  bibliography, county, municipality, ddc1, ddc2, ddc3, genre, languages, literaryform, mediatype, relationType, series, set, targetaudience, year","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"searchType","in":"query","description":"Search in fulltext/ocr, metadata or both (default)","required":false,"schema":{"type":"string","default":"FULL_TEXT_SEARCH","enum":["TEXT_SEARCH","FIELD_RESTRICTED_SEARCH","FULL_TEXT_SEARCH"]}},{"name":"digitalAccessibleOnly","in":"query","description":"Search only in the material that you have the rights to look at","required":false,"schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"Expand metadata or relatedItems","required":false,"schema":{"type":"string","enum":["metadata","relatedItems"]}},{"name":"filter","in":"query","description":"Filter query to narrow search results. Format: field:value. Multiple filters are supported. <br/><b>Standard filters</b>: field:value passed as search engine query_string, e.g. mediatype:aviser, languages:nob, digital:Ja <br/>Supported query fields: <br/>collection, contentclasses, county, municipality, ddc, description, digital,\nfreetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype,\nname, namecreators, nameauthor, oaiid, origininfoplace, publisher,\nrelationtype, sesamid, series, seriestitle, set, subject, subjectgeographic,\nsubjectname, subjecttopic, targetaudience, title, title_alternative, year, urn <br/><b>API text filters</b> (text search with accent folding): <br/>Supported query fields: <br/>api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace <br/><b>Date range filters</b>: date:[yyyyMMdd TO yyyyMMdd], firstDigitalContentTime:[yyyyMMdd TO yyyyMMdd], lastModified:[yyyyMMdd TO yyyyMMdd]","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aq","in":"query","description":"Aggregations query, filter on aggregated values, ex.: county:Nordland","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"snippets","in":"query","description":"Snippets/fragments, specified per material type, ex.: aviser","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32"},"example":2},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32"},"example":500},{"name":"random","in":"query","description":"Arbitrary ranking of hits","required":false,"schema":{"type":"boolean"}},{"name":"profile","in":"query","description":"Application Profile","required":false,"schema":{"type":"string","enum":["wwwnbno","nbdigital","beta","dfb","frigg","valhall","statfjord","statsmaktene","draugen","ekofisk","equinor50","industriminne"],"example":"wwwnbno"}},{"name":"searchAfterId","in":"query","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"size","in":"query","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ItemSearchEntityModel"}}}}}}},"/catalog/v1/aggregations":{"get":{"tags":["aggregations"],"summary":"Get aggregations/facets","description":"Returns aggregation counts (facets) for a given query without returning item results. Useful for building filter navigation showing counts per media type, language, year, etc.","operationId":"aggregations","parameters":[{"name":"q","in":"query","description":"Search query string. Supports free text and field-restricted queries. Field queries use the syntax field:value and can be combined with free text. <br/>For better performance, use the 'filter' parameter instead of field-restricted queries in 'q'. <br/>Supported query fields: api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace, collection, contentclasses, county, municipality, ddc, description, digital, freetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype, name, namecreators, nameauthor, oaiid, origininfoplace, publisher, relationtype, sesamid, series, seriestitle, set, subject, subjectgeographic, subjectname, subjecttopic, targetaudience, title, title_alternative, year, urn","required":true,"schema":{"type":"string"},"example":"hamsun"},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported. <br/>Allowable values: date, title, otherid, firstDigitalContentTime","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aggs","in":"query","description":"Aggregations, format: field(:count:order). <br/>Default size: 50, default order: countdesc. Allowable order values: countasc, countdesc, termasc, termdesc <br/>Allowable values:  bibliography, county, municipality, ddc1, ddc2, ddc3, genre, languages, literaryform, mediatype, relationType, series, set, targetaudience, year","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"searchType","in":"query","description":"Search in fulltext/ocr, metadata or both (default)","required":false,"schema":{"type":"string","default":"FULL_TEXT_SEARCH","enum":["TEXT_SEARCH","FIELD_RESTRICTED_SEARCH","FULL_TEXT_SEARCH"]}},{"name":"digitalAccessibleOnly","in":"query","description":"Search only in the material that you have the rights to look at","required":false,"schema":{"type":"boolean"}},{"name":"expand","in":"query","description":"Expand metadata or relatedItems","required":false,"schema":{"type":"string","enum":["metadata","relatedItems"]}},{"name":"filter","in":"query","description":"Filter query to narrow search results. Format: field:value. Multiple filters are supported. <br/><b>Standard filters</b>: field:value passed as search engine query_string, e.g. mediatype:aviser, languages:nob, digital:Ja <br/>Supported query fields: <br/>collection, contentclasses, county, municipality, ddc, description, digital,\nfreetext, gendate, isbn, issn, ismn, languages, literaryform, mediatype,\nname, namecreators, nameauthor, oaiid, origininfoplace, publisher,\nrelationtype, sesamid, series, seriestitle, set, subject, subjectgeographic,\nsubjectname, subjecttopic, targetaudience, title, title_alternative, year, urn <br/><b>API text filters</b> (text search with accent folding): <br/>Supported query fields: <br/>api_namecreators, api_nameauthor, api_namerecipient, api_nameactor, api_namecomposer, api_nameproducer, api_namedirector, api_mainartist, api_namehost, api_name, api_title, api_subject, api_series, api_seriestitle, api_subjectgeographic, api_subjecttopic, api_origininfoplace <br/><b>Date range filters</b>: date:[yyyyMMdd TO yyyyMMdd], firstDigitalContentTime:[yyyyMMdd TO yyyyMMdd], lastModified:[yyyyMMdd TO yyyyMMdd]","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"aq","in":"query","description":"Aggregations query, filter on aggregated values, ex.: county:Nordland","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"snippets","in":"query","description":"Snippets/fragments, specified per material type, ex.: aviser","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"fragments","in":"query","description":"Number of fragments","required":false,"schema":{"type":"integer","format":"int32"},"example":2},{"name":"fragSize","in":"query","description":"Number of characters in each fragment","required":false,"schema":{"type":"integer","format":"int32"},"example":500},{"name":"random","in":"query","description":"Arbitrary ranking of hits","required":false,"schema":{"type":"boolean"}},{"name":"profile","in":"query","description":"Application Profile","required":false,"schema":{"type":"string","enum":["wwwnbno","nbdigital","beta","dfb","frigg","valhall","statfjord","statsmaktene","draugen","ekofisk","equinor50","industriminne"],"example":"wwwnbno"}}],"responses":{"500":{"description":"Internal Server Error"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"default":{"description":"default response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ItemSearchEntityModel"}}}}}}}},"components":{"schemas":{"AccessInfo":{"type":"object","properties":{"accessAllowedFrom":{"type":"string"},"viewability":{"type":"string"},"license":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"legalDepositReservationStatus":{"type":"string"},"legalDepositLoginText":{"type":"string"},"accessInfoLastModified":{"type":"string"},"isDigital":{"type":"boolean"},"isPublicDomain":{"type":"boolean"}}},"Classification":{"type":"object","properties":{"ddc":{"type":"array","items":{"type":"string"}},"udc":{"type":"array","items":{"type":"string"}}}},"Collection":{"type":"object","properties":{"accessProject":{"type":"array","items":{"type":"string"}},"accessCollection":{"type":"array","items":{"type":"string"}}}},"Conferences":{"type":"object","properties":{"name":{"type":"array","items":{"type":"string"}},"date":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Role"}},"usage":{"type":"string"},"identifier":{"type":"string"}}},"ContentFragmentEntityModel":{"type":"object","properties":{"pageid":{"type":"string"},"text":{"type":"string"},"pageNumber":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"}}},"Coordinates":{"type":"object","properties":{"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"}}},"Corporates":{"type":"object","properties":{"name":{"type":"array","items":{"type":"string"}},"date":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Role"}},"usage":{"type":"string"},"identifier":{"type":"string"}}},"EmbeddedWrapper":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ItemEntityModel"}},"aggregations":{"$ref":"#/components/schemas/JsonNode"},"contentFragmentResource":{"type":"array","items":{"$ref":"#/components/schemas/ContentFragmentEntityModel"}}}},"EnumChron":{"type":"object","properties":{"volume":{"type":"string"},"number":{"type":"string"},"consecutive_number":{"type":"string"},"year":{"type":"string"},"month_season":{"type":"string"},"date_in_month":{"type":"string"}}},"Geographic":{"type":"object","properties":{"placeString":{"type":"string"},"place":{"$ref":"#/components/schemas/Place"},"coordinates":{"$ref":"#/components/schemas/Coordinates"},"city":{"type":"string"},"county":{"type":"string"}}},"Identifiers":{"type":"object","properties":{"isbn10":{"type":"array","items":{"type":"string"}},"isbn13":{"type":"array","items":{"type":"string"}},"issn":{"type":"array","items":{"type":"string"}},"ismn":{"type":"array","items":{"type":"string"}},"sesamId":{"type":"string"},"oaiId":{"type":"string"},"urn":{"type":"string"},"matrixNumber":{"type":"array","items":{"type":"string"}},"issueNumber":{"type":"array","items":{"type":"string"}},"isrc":{"type":"array","items":{"type":"string"}},"local":{"type":"array","items":{"type":"string"}},"seriestitleid":{"type":"string"},"seriesid":{"type":"string"},"otherid":{"type":"array","items":{"type":"string"}}}},"ItemEntityModel":{"type":"object","properties":{"expand":{"type":"string"},"id":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"},"accessInfo":{"$ref":"#/components/schemas/AccessInfo"},"metadata":{"$ref":"#/components/schemas/Metadata"},"contentFragments":{"type":"array","items":{"$ref":"#/components/schemas/ContentFragmentEntityModel"}},"relatedItems":{"$ref":"#/components/schemas/RelatedItemEntityModel"},"explain":{"$ref":"#/components/schemas/JsonNode"}}},"ItemSearchEntityModel":{"type":"object","properties":{"debugQuery":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"},"page":{"$ref":"#/components/schemas/PageMetadata"},"_embedded":{"$ref":"#/components/schemas/EmbeddedWrapper"}}},"JsonNode":{"type":"object","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"number":{"type":"boolean"},"string":{"type":"boolean"},"boolean":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"integralNumber":{"type":"boolean"},"pojo":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"binary":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"missingNode":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"Language":{"type":"object","properties":{"code":{"type":"string"},"objectPart":{"type":"string"}}},"MediaTypeResult":{"type":"object","properties":{"mediaType":{"type":"string"},"result":{"$ref":"#/components/schemas/ItemSearchEntityModel"}}},"Metadata":{"type":"object","properties":{"title":{"type":"string"},"titleInfos":{"type":"array","items":{"$ref":"#/components/schemas/TitleInfo"}},"typeOfResource":{"type":"string"},"genres":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"people":{"type":"array","items":{"$ref":"#/components/schemas/Person"}},"corporates":{"type":"array","items":{"$ref":"#/components/schemas/Corporates"}},"geographic":{"$ref":"#/components/schemas/Geographic"},"originInfo":{"$ref":"#/components/schemas/OriginInfo"},"originInfoTypes":{"type":"array","items":{"$ref":"#/components/schemas/OriginInfoType"}},"recordInfo":{"$ref":"#/components/schemas/RecordInfo"},"classification":{"$ref":"#/components/schemas/Classification"},"collection":{"$ref":"#/components/schemas/Collection"},"identifiers":{"$ref":"#/components/schemas/Identifiers"},"notes":{"type":"array","items":{"type":"string"}},"note":{"$ref":"#/components/schemas/Note"},"subject":{"$ref":"#/components/schemas/Subject"},"statementOfResponsibility":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/Language"}},"streamingInfo":{"type":"array","items":{"$ref":"#/components/schemas/StreamingInfo"}},"pageCount":{"type":"integer","format":"int32"},"mediaTypes":{"type":"array","items":{"type":"string"}},"creators":{"type":"array","items":{"type":"string"}},"contentClasses":{"type":"array","items":{"type":"string"}},"metadataClasses":{"type":"array","items":{"type":"string"}},"dateCreated":{"type":"string"},"series":{"type":"array","items":{"type":"string"}},"seriesuniform":{"type":"array","items":{"type":"string"}},"namehosts":{"type":"array","items":{"type":"string"}},"nameauthors":{"type":"array","items":{"type":"string"}},"namerecipients":{"type":"array","items":{"type":"string"}},"nameactors":{"type":"array","items":{"type":"string"}},"namecomposers":{"type":"array","items":{"type":"string"}},"nameproducers":{"type":"array","items":{"type":"string"}},"namedirectors":{"type":"array","items":{"type":"string"}},"mainartist":{"type":"array","items":{"type":"string"}},"subjectName":{"type":"array","items":{"type":"string"}},"titleAlternative":{"type":"array","items":{"type":"string"}},"tableOfContents":{"type":"array","items":{"type":"string"}},"targetAudience":{"type":"array","items":{"type":"string"}},"targetAudienceJuvenile":{"type":"array","items":{"type":"string"}},"targetAudienceNotes":{"type":"array","items":{"type":"string"}},"literaryform":{"type":"string"},"physicalDescription":{"$ref":"#/components/schemas/PhysicalDescription"},"relatedItems":{"type":"array","items":{"$ref":"#/components/schemas/RelatedItem"}},"owner":{"type":"string"},"relationType":{"type":"string"},"rightsNotes":{"type":"array","items":{"type":"string"}},"enumChron":{"$ref":"#/components/schemas/EnumChron"},"originalVersionNotes":{"type":"array","items":{"type":"string"}}}},"Note":{"type":"object","properties":{"acquisition":{"type":"array","items":{"type":"string"}},"action":{"type":"array","items":{"type":"string"}},"additionalPhysicalForm":{"type":"array","items":{"type":"string"}},"arrangement":{"type":"array","items":{"type":"string"}},"bibliography":{"type":"array","items":{"type":"string"}},"biographicalHistorical":{"type":"array","items":{"type":"string"}},"creationProductionCredits":{"type":"array","items":{"type":"string"}},"dateSequentialDesignation":{"type":"array","items":{"type":"string"}},"exhibitions":{"type":"array","items":{"type":"string"}},"funding":{"type":"array","items":{"type":"string"}},"language":{"type":"array","items":{"type":"string"}},"numbering":{"type":"array","items":{"type":"string"}},"originalLocation":{"type":"array","items":{"type":"string"}},"ownership":{"type":"array","items":{"type":"string"}},"performers":{"type":"array","items":{"type":"string"}},"preferredCitation":{"type":"array","items":{"type":"string"}},"publicationInformation":{"type":"array","items":{"type":"string"}},"publications":{"type":"array","items":{"type":"string"}},"reproduction":{"type":"array","items":{"type":"string"}},"statementOfResponsibility":{"type":"array","items":{"type":"string"}},"systemDetails":{"type":"array","items":{"type":"string"}},"venue":{"type":"array","items":{"type":"string"}},"versionIdentification":{"type":"array","items":{"type":"string"}},"thesis":{"type":"array","items":{"type":"string"}}}},"OriginInfo":{"type":"object","properties":{"publisher":{"type":"string"},"issued":{"type":"string"},"issuedUntouched":{"type":"string"},"frequency":{"type":"string"},"created":{"type":"string"},"captured":{"type":"string"},"modified":{"type":"string"},"edition":{"type":"string"},"firstIndexTime":{"type":"string"},"firstDigitalContentTime":{"type":"string"},"indexLastModified":{"type":"string"},"dateCreatedStart":{"type":"string"},"dateCreatedEnd":{"type":"string"},"copyrightDate":{"type":"string"},"dateIssuedStart":{"type":"string"},"dateIssuedEnd":{"type":"string"}}},"OriginInfoType":{"type":"object","properties":{"eventType":{"type":"string"},"placeTerms":{"type":"array","items":{"type":"string"}},"publisher":{"type":"string"},"issued":{"type":"string"},"issuedUntouched":{"type":"string"},"frequency":{"type":"string"},"created":{"type":"string"},"captured":{"type":"string"},"modified":{"type":"string"},"edition":{"type":"string"},"firstIndexTime":{"type":"string"},"firstDigitalContentTime":{"type":"string"},"indexLastModified":{"type":"string"},"dateCreatedStart":{"type":"string"},"dateCreatedEnd":{"type":"string"},"dateValid":{"type":"string"},"copyrightDate":{"type":"string"},"dateOther":{"type":"string"},"dateIssuedStart":{"type":"string"},"dateIssuedEnd":{"type":"string"}}},"PageMetadata":{"type":"object","properties":{"size":{"type":"integer","format":"int64"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"number":{"type":"integer","format":"int64"}}},"Person":{"type":"object","properties":{"name":{"type":"string"},"termsOfAddress":{"type":"string"},"date":{"type":"string"},"affiliation":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Role"}},"usage":{"type":"string"},"identifier":{"type":"string"}}},"PhysicalDescription":{"type":"object","properties":{"form":{"type":"array","items":{"type":"string"}},"extent":{"type":"string"}}},"Place":{"type":"object","properties":{"country":{"type":"string"},"region":{"type":"string"},"city":{"type":"string"},"area":{"type":"string"}}},"RecordInfo":{"type":"object","properties":{"identifier":{"type":"string"},"identifierSource":{"type":"string"},"created":{"type":"string"}}},"RelatedItem":{"type":"object","properties":{"name":{"type":"array","items":{"type":"string"}},"type":{"type":"string"}}},"RelatedItemEntityModel":{"type":"object","properties":{"hosts":{"type":"array","items":{"$ref":"#/components/schemas/ItemEntityModel"}},"constituents":{"type":"array","items":{"$ref":"#/components/schemas/ItemEntityModel"}},"preceding":{"$ref":"#/components/schemas/ItemEntityModel"},"succeding":{"$ref":"#/components/schemas/ItemEntityModel"},"series":{"$ref":"#/components/schemas/ItemEntityModel"},"itemId":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"},"id":{"type":"string"}}},"Role":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}}},"StreamingInfo":{"type":"object","properties":{"identifier":{"type":"string"},"offset":{"type":"integer","format":"int32"},"extent":{"type":"integer","format":"int32"}}},"Subject":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"string"}},"persons":{"type":"array","items":{"$ref":"#/components/schemas/Person"}},"corporates":{"type":"array","items":{"$ref":"#/components/schemas/Corporates"}},"geographics":{"type":"array","items":{"type":"string"}},"genres":{"type":"array","items":{"type":"string"}},"titleInfos":{"type":"array","items":{"type":"string"}},"conferences":{"type":"array","items":{"$ref":"#/components/schemas/Conferences"}}}},"SuperEmbeddedWrapper":{"type":"object","properties":{"mediaTypeResults":{"type":"array","items":{"$ref":"#/components/schemas/MediaTypeResult"}},"aggregations":{"$ref":"#/components/schemas/JsonNode"}}},"SuperItemSearchEntityModel":{"type":"object","properties":{"totalElements":{"type":"integer","format":"int64"},"_links":{"$ref":"#/components/schemas/Links"},"_embedded":{"$ref":"#/components/schemas/SuperEmbeddedWrapper"}}},"TitleInfo":{"type":"object","properties":{"title":{"type":"string"},"subTitle":{"type":"string"},"type":{"type":"string"},"partNumber":{"type":"string"},"partName":{"type":"string"},"displayLabel":{"type":"string"}}},"Pageable":{"type":"object","properties":{"page":{"type":"integer","format":"int32","minimum":0},"size":{"type":"integer","format":"int32","minimum":1},"sort":{"type":"array","items":{"type":"string"}}}},"MusicEmbeddedWrapper":{"type":"object","properties":{"subMediaTypeResults":{"type":"array","items":{"$ref":"#/components/schemas/SubMediaTypeResult"}},"aggregations":{"$ref":"#/components/schemas/JsonNode"}}},"MusicItemSearchEntityModel":{"type":"object","properties":{"totalElements":{"type":"integer","format":"int64"},"_links":{"$ref":"#/components/schemas/Links"},"_embedded":{"$ref":"#/components/schemas/MusicEmbeddedWrapper"}}},"SubMediaTypeResult":{"type":"object","properties":{"subMediaType":{"type":"string"},"result":{"$ref":"#/components/schemas/ItemSearchEntityModel"}}},"ContentFragmentsEntityModel":{"type":"object","properties":{"_links":{"$ref":"#/components/schemas/Links"},"contentFragments":{"type":"array","items":{"$ref":"#/components/schemas/ContentFragmentEntityModel"}}}},"Link":{"type":"object","properties":{"href":{"type":"string"},"hreflang":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"},"deprecation":{"type":"string"},"profile":{"type":"string"},"name":{"type":"string"},"templated":{"type":"boolean"}}},"Links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Link"}}}}}