# SPDX-License-Identifier: AGPL-3.0-or-later """Library of Congress: query Photo, Print and Drawing from API endpoint_ ``photos``. .. _endpoint: https://www.loc.gov/apis/json-and-yaml/requests/endpoints/ .. note:: Beside the ``photos`` endpoint_ there are more endpoints available / we are looking forward for contributions implementing more endpoints. """ from urllib.parse import urlencode from searx.network import raise_for_httperror about = { "website": 'https://www.loc.gov/pictures/', "wikidata_id": 'Q131454', "official_api_documentation": 'https://www.loc.gov/api', "use_official_api": True, "require_api_key": False, "results": 'JSON', } categories = ['images'] paging = True endpoint = 'photos' base_url = 'https://www.loc.gov' search_string = "/{endpoint}/?sp={page}&{query}&fo=json" def request(query, params): search_path = search_string.format( endpoint=endpoint, query=urlencode({'q': query}), page=params['pageno'], ) params['url'] = base_url + search_path params['raise_for_httperror'] = False return params def response(resp): results = [] json_data = resp.json() json_results = json_data.get('results') if not json_results: # when a search term has none results, loc sends a JSON in a HTTP 404 # response and the HTTP status code is set in the 'status' element. if json_data.get('status') == 404: return results raise_for_httperror(resp) for result in json_results: url = result["item"].get("link") if not url: continue img_src = result['item'].get('service_medium') if not img_src or img_src == 'https://memory.loc.gov/pp/grp.gif': continue title = result['title'] if title.startswith('['): title = title.strip('[]') content_items = [ result['item'].get('created_published_date'), result['item'].get('summary', [None])[0], result['item'].get('notes', [None])[0], result['item'].get('part_of', [None])[0], ] author = None if result['item'].get('creators'): author = result['item']['creators'][0]['title'] results.append( { 'template': 'images.html', 'url': url, 'title': title, 'content': ' / '.join([i for i in content_items if i]), 'img_src': img_src, 'thumbnail_src': result['item'].get('thumb_gallery'), 'author': author, } ) return results