Functions
	init (_)

	request (query, params)

	response (resp)

Variables
dict	about

str	base_url = 'https://api.adsabs.harvard.edu/v1/search'

str	result_base_url = 'https://ui.adsabs.harvard.edu/abs/'

int	rows = 10

str	sort = ''

list	field_list = ['bibcode', 'author', 'title', 'abstract', 'doi', 'date']

str	default_fields = ''

str	query_fields = ''

bool	paging = True

str	api_key = 'unset'

Detailed Description

.. sidebar:: info

The Astrophysics Data System (ADS) is a digital library portal for researchers in astronomy and physics,
operated by the Smithsonian Astrophysical Observatory (SAO) under a NASA grant.
The engine is adapted from the solr engine.

Function Documentation

◆ init()

searx.engines.astrophysics_data_system.init ( _ )

Definition at line 37 of file astrophysics_data_system.py.

def init(_):
    if api_key == 'unset':
        raise SearxEngineAPIException('missing ADS API key')
 
 

◆ request()

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

Definition at line 42 of file astrophysics_data_system.py.

def request(query, params):
    query_params = {'q': query, 'rows': rows}
    if field_list:
        query_params['fl'] = ','.join(field_list)
    if query_fields:
        query_params['qf'] = ','.join(query_fields)
    if default_fields:
        query_params['df'] = default_fields
    if sort:
        query_params['sort'] = sort
 
    query_params['start'] = rows * (params['pageno'] - 1)
 
    params['headers']['Authorization'] = f'Bearer {api_key}'
    params['url'] = f"{base_url}/query?{urlencode(query_params)}"
 
    return params
 
 

◆ response()

searx.engines.astrophysics_data_system.response ( resp )

Definition at line 61 of file astrophysics_data_system.py.

def response(resp):
    try:
        resp_json = loads(resp.text)
    except Exception as e:
        raise SearxEngineAPIException("failed to parse response") from e
 
    if 'error' in resp_json:
        raise SearxEngineAPIException(resp_json['error']['msg'])
 
    resp_json = resp_json["response"]
    result_len = resp_json["numFound"]
    results = []
 
    for res in resp_json["docs"]:
        author = res.get("author")
 
        if author:
            author = author[0] + ' et al.'
 
        results.append(
            {
                'url': result_base_url + res.get("bibcode") + "/",
                'title': res.get("title")[0],
                'author': author,
                'content': res.get("abstract"),
                'doi': res.get("doi"),
                'publishedDate': datetime.fromisoformat(res.get("date")),
            }
        )
 
    results.append({'number_of_results': result_len})
 
    return results

Variable Documentation

◆ about

dict searx.engines.astrophysics_data_system.about

Initial value:

=  {
    "website": 'https://ui.adsabs.harvard.edu/',
    "wikidata_id": 'Q752099',
    "official_api_documentation": 'https://ui.adsabs.harvard.edu/help/api/api-docs.html',
    "use_official_api": True,
    "require_api_key": True,
    "results": 'JSON',
}