Functions
	request (query, params)

	response (resp)

Variables
dict	about

list	categories = ["movies"]

bool	paging = False

str	suggestion_url = "https://v2.sg.media-imdb.com/suggestion/{letter}/{query}.json"

str	href_base = 'https://imdb.com/{category}/{entry_id}'

dict	search_categories = {"nm": "name", "tt": "title", "kw": "keyword", "co": "company", "ep": "episode"}

Detailed Description

IMDB - Internet Movie Database

Retrieves results from a basic search.  Advanced search options are not
supported.  IMDB's API is undocumented, here are some posts about:

- https://stackoverflow.com/questions/1966503/does-imdb-provide-an-api
- https://rapidapi.com/blog/how-to-use-imdb-api/

An alternative that needs IMDPro_ is `IMDb and Box Office Mojo
<https://developer.imdb.com/documentation>`_

.. __IMDPro: https://pro.imdb.com/login

Function Documentation

◆ request()

searx.engines.imdb.request	(		query,
			params )

Definition at line 39 of file imdb.py.

def request(query, params):
 
    query = query.replace(" ", "_").lower()
    params['url'] = suggestion_url.format(letter=query[0], query=query)
 
    return params

◆ response()

searx.engines.imdb.response ( resp )

Definition at line 47 of file imdb.py.

def response(resp):
 
    suggestions = json.loads(resp.text)
    results = []
 
    for entry in suggestions.get('d', []):
 
        # https://developer.imdb.com/documentation/key-concepts#imdb-ids
        entry_id = entry['id']
        categ = search_categories.get(entry_id[:2])
        if categ is None:
            logger.error('skip unknown category tag %s in %s', entry_id[:2], entry_id)
            continue
 
        title = entry['l']
        if 'q' in entry:
            title += " (%s)" % entry['q']
 
        content = ''
        if 'rank' in entry:
            content += "(%s) " % entry['rank']
        if 'y' in entry:
            content += str(entry['y']) + " - "
        if 's' in entry:
            content += entry['s']
 
        # imageUrl is the image itself, it is not a thumb!
        image_url = entry.get('i', {}).get('imageUrl')
        if image_url:
            # get thumbnail
            image_url_name, image_url_prefix = image_url.rsplit('.', 1)
            # recipe to get the magic value:
            #  * search on imdb.com, look at the URL of the thumbnail on the right side of the screen
            #  * search using the imdb engine, compare the imageUrl and thumbnail URL
            # QL75 : JPEG quality (?)
            # UX280 : resize to width 320
            # 280,414 : size of the image (add white border)
            magic = 'QL75_UX280_CR0,0,280,414_'
            if not image_url_name.endswith('_V1_'):
                magic = '_V1_' + magic
            image_url = image_url_name + magic + '.' + image_url_prefix
        results.append(
            {
                "title": title,
                "url": href_base.format(category=categ, entry_id=entry_id),
                "content": content,
                "thumbnail": image_url,
            }
        )
 
    return results

Variable Documentation

◆ about

dict searx.engines.imdb.about

Initial value:

=  {
    "website": 'https://imdb.com/',
    "wikidata_id": 'Q37312',
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": False,
    "results": 'HTML',
}

Definition at line 19 of file imdb.py.

◆ categories

list searx.engines.imdb.categories = ["movies"]

Definition at line 28 of file imdb.py.

◆ href_base

str searx.engines.imdb.href_base = 'https://imdb.com/{category}/{entry_id}'

Definition at line 34 of file imdb.py.

◆ paging

bool searx.engines.imdb.paging = False

Definition at line 29 of file imdb.py.

◆ search_categories

dict searx.engines.imdb.search_categories = {"nm": "name", "tt": "title", "kw": "keyword", "co": "company", "ep": "episode"}

Definition at line 36 of file imdb.py.

◆ suggestion_url

str searx.engines.imdb.suggestion_url = "https://v2.sg.media-imdb.com/suggestion/{letter}/{query}.json"

Definition at line 32 of file imdb.py.

Functions

Variables