Functions
	request (query, params)

	response (resp)

Variables
dict	about

bool	paging = True

list	categories = ["movies"]

str	base_url = "https://www.moviepilot.de"

str	image_url = "https://assets.cdn.moviepilot.de/files/{image_id}/fill/155/223/{filename}"

list	filter_types = ["fsk", "genre", "jahr", "jahrzehnt", "land", "online", "stimmung", "person"]

Detailed Description

Moviepilot is a German movie database, similar to IMDB or TMDB.  It doesn't
have any official API, but it uses JSON requests internally to fetch search
results and suggestions, that's being used in this implementation.

Moviepilot additionally allows to discover movies by certain categories
or filters, hence we provide the following syntax:

- Any normal search query -> Fetch search results by the query

- A query containing one of the category identifiers ``fsk``, ``genre``,
  ``jahr``, ``jahrzent``, ``land``, ``online``, ``stimmung`` will be used to
  search trending items by the provided filters, which are appended to the
  filter category after a ``-``.

Search examples:

- Normal: ``!mp Tom Cruise``
- By filter: ``!mp person-Ryan-Gosling``
- By filter: ``!mp fsk-0 land-deutschland genre-actionfilm``
- By filter: ``!mp jahrzehnt-2020er online-netflix``

For a list of all public filters, observe the url path when browsing

- https://www.moviepilot.de/filme/beste.

Function Documentation

◆ request()

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

Definition at line 49 of file moviepilot.py.

def request(query, params):
    query_parts = query.split(" ")
 
    discovery_filters = []
    for query_part in query_parts:
        filter_category_and_value = query_part.split("-", 1)
 
        if len(filter_category_and_value) < 2:
            continue
 
        filter_category = filter_category_and_value[0]
 
        if filter_category in filter_types:
            discovery_filters.append(query_part)
 
    params['discovery'] = len(discovery_filters) != 0
 
    if params['discovery']:
        args = {
            'page': params['pageno'],
            'order': 'beste',
        }
        params["url"] = f"{base_url}/api/discovery?{urlencode(args)}"
        for discovery_filter in discovery_filters:
            params["url"] += f"&filters[]={discovery_filter}"
    else:
        args = {
            'q': query,
            'page': params['pageno'],
            'type': 'suggest',
        }
        params["url"] = f"{base_url}/api/search?{urlencode(args)}"
 
    return params
 
 

◆ response()

searx.engines.moviepilot.response ( resp )

Definition at line 85 of file moviepilot.py.

def response(resp):
    results = []
 
    json = resp.json()
 
    json_results = []
 
    if resp.search_params['discovery']:
        json_results = json['results']
    else:
        json_results = json
 
    for result in json_results:
        item = {'title': result['title']}
 
        if resp.search_params['discovery']:
            content_list = [result.get(x) for x in ['abstract', 'summary']]
            item['url'] = base_url + result['path']
            item['content'] = html_to_text(' | '.join([x for x in content_list if x]))
            item['metadata'] = html_to_text(result.get('meta_short', ''))
 
            if result.get('image'):
                item['img_src'] = image_url.format(image_id=result['image'], filename=result['image_filename'])
        else:
            item['url'] = result['url']
            item['content'] = ', '.join([result['class'], result['info'], result['more']])
            item['img_src'] = result['image']
 
        results.append(item)
 
    return results

Variable Documentation

◆ about

dict searx.engines.moviepilot.about

Initial value:

=  {
    'website': "https://www.moviepilot.de",
    'official_api_documentation': None,
    'use_official_api': False,
    'require_api_key': False,
    'results': 'JSON',
    'language': 'de',
}

Definition at line 32 of file moviepilot.py.

◆ base_url

str searx.engines.moviepilot.base_url = "https://www.moviepilot.de"

Definition at line 43 of file moviepilot.py.

◆ categories

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

Definition at line 41 of file moviepilot.py.

◆ filter_types

list searx.engines.moviepilot.filter_types = ["fsk", "genre", "jahr", "jahrzehnt", "land", "online", "stimmung", "person"]

Definition at line 46 of file moviepilot.py.

◆ image_url

str searx.engines.moviepilot.image_url = "https://assets.cdn.moviepilot.de/files/{image_id}/fill/155/223/{filename}"

Definition at line 44 of file moviepilot.py.

◆ paging

bool searx.engines.moviepilot.paging = True

Definition at line 40 of file moviepilot.py.

Functions

Variables