searxng/searx/engines/loc.py

# SPDX-License-Identifier: AGPL-3.0-or-later
"""

 Library of Congress : images from Prints and Photographs Online Catalog

"""

from json import loads
from urllib.parse import urlencode


about = {
    "website": 'https://www.loc.gov/pictures/',
    "wikidata_id": 'Q131454',
    "official_api_documentation": 'https://www.loc.gov/pictures/api',
    "use_official_api": True,
    "require_api_key": False,
    "results": 'JSON',
}

categories = ['images']

paging = True

base_url = 'https://loc.gov/pictures/search/?'
search_string = "&sp={page}&{query}&fo=json"

IMG_SRC_FIXES = {
    'https://tile.loc.gov/storage-services/': 'https://tile.loc.gov/storage-services/',
    'https://loc.gov/pictures/static/images/': 'https://tile.loc.gov/storage-services/',
    'https://www.loc.gov/pictures/cdn/': 'https://tile.loc.gov/storage-services/',
}


def request(query, params):

    search_path = search_string.format(query=urlencode({'q': query}), page=params['pageno'])

    params['url'] = base_url + search_path

    return params


def response(resp):
    results = []

    json_data = loads(resp.text)

    for result in json_data['results']:
        img_src = result['image']['full']
        for url_prefix, url_replace in IMG_SRC_FIXES.items():
            if img_src.startswith(url_prefix):
                img_src = img_src.replace(url_prefix, url_replace)
                break
        else:
            img_src = result['image']['thumb']
        results.append(
            {
                'url': result['links']['item'],
                'title': result['title'],
                'img_src': img_src,
                'thumbnail_src': result['image']['thumb'],
                'author': result['creator'],
                'template': 'images.html',
            }
        )

    return results