Functions
	request (query, params)

	response (resp)

	_story (item)

	_video (item)

Variables
logging	logger .Logger

dict	about

list	categories = ['general', 'news']

bool	paging = True

int	results_per_page = 10

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

bool	use_source_url = True

Detailed Description

ARD: `Tagesschau API`_

The Tagesschau is a news program of the ARD.  Via the `Tagesschau API`_, current
news and media reports are available in JSON format.  The `Bundesstelle für Open
Data`_ offers a `OpenAPI`_ portal at bundDEV_ where APIs are documented an can
be tested.

This SearXNG engine uses the `/api2u/search`_ API.

.. _/api2u/search: http://tagesschau.api.bund.dev/
.. _bundDEV: https://bund.dev/apis
.. _Bundesstelle für Open Data: https://github.com/bundesAPI
.. _Tagesschau API: https://github.com/AndreasFischer1985/tagesschau-api/blob/main/README_en.md
.. _OpenAPI: https://swagger.io/specification/

Function Documentation

◆ _story()

searx.engines.tagesschau._story ( item )

protected

Definition at line 85 of file tagesschau.py.

def _story(item):
    return {
        'title': item['title'],
        'thumbnail': item.get('teaserImage', {}).get('imageVariants', {}).get('16x9-256'),
        'publishedDate': datetime.strptime(item['date'][:19], '%Y-%m-%dT%H:%M:%S'),
        'content': item['firstSentence'],
        'url': item['shareURL'] if use_source_url else item['detailsweb'],
    }
 
 

Referenced by searx.engines.tagesschau.response().

Here is the caller graph for this function:

◆ _video()

searx.engines.tagesschau._video ( item )

protected

Definition at line 95 of file tagesschau.py.

def _video(item):
    streams = item['streams']
    video_url = streams.get('h264s') or streams.get('h264m') or streams.get('h264l') or streams.get('h264xl')
    title = item['title']
 
    if "_vapp.mxf" in title:
        title = title.replace("_vapp.mxf", "")
        title = re.sub(r"APP\d+ (FC-)?", "", title, count=1)
 
    return {
        'template': 'videos.html',
        'title': title,
        'thumbnail': item.get('teaserImage', {}).get('imageVariants', {}).get('16x9-256'),
        'publishedDate': datetime.strptime(item['date'][:19], '%Y-%m-%dT%H:%M:%S'),
        'content': item.get('firstSentence', ''),
        'iframe_src': video_url,
        'url': video_url,
    }

Referenced by searx.engines.tagesschau.response().

Here is the caller graph for this function:

◆ request()

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

Definition at line 56 of file tagesschau.py.

def request(query, params):
    args = {
        'searchText': query,
        'pageSize': results_per_page,
        'resultPage': params['pageno'] - 1,
    }
 
    params['url'] = f"{base_url}/api2u/search?{urlencode(args)}"
 
    return params
 
 

◆ response()

searx.engines.tagesschau.response ( resp )

Definition at line 68 of file tagesschau.py.

def response(resp):
    results = []
 
    json = resp.json()
 
    for item in json['searchResults']:
        item_type = item.get('type')
        if item_type in ('story', 'webview'):
            results.append(_story(item))
        elif item_type == 'video':
            results.append(_video(item))
        else:
            logger.error("unknow result type: %s", item_type)
 
    return results
 
 

References searx.engines.tagesschau._story(), and searx.engines.tagesschau._video().

Here is the call graph for this function:

Variable Documentation

◆ about

dict searx.engines.tagesschau.about

Initial value:

=  {
    'website': "https://tagesschau.de",
    'wikidata_id': "Q703907",
    'official_api_documentation': None,
    'use_official_api': True,
    'require_api_key': False,
    'results': 'JSON',
    'language': 'de',
}

Definition at line 29 of file tagesschau.py.

◆ base_url

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

Definition at line 42 of file tagesschau.py.

◆ categories

list searx.engines.tagesschau.categories = ['general', 'news']

Definition at line 38 of file tagesschau.py.

◆ logger

logging searx.engines.tagesschau.logger .Logger

Definition at line 27 of file tagesschau.py.

◆ paging

bool searx.engines.tagesschau.paging = True

Definition at line 39 of file tagesschau.py.

◆ results_per_page

int searx.engines.tagesschau.results_per_page = 10

Definition at line 41 of file tagesschau.py.

◆ use_source_url

bool searx.engines.tagesschau.use_source_url = True

Definition at line 44 of file tagesschau.py.

Functions

Variables