Functions
bool	setup (dict[str, t.Any] engine_settings)
None	request (str query, "OnlineParams" params)
EngineResults	response ("SXNG_Response" resp)

Variables
dict	about
list	categories = ["science", "scientific publications"]
bool	paging = True
str	base_url = "https://api.adsabs.harvard.edu/v1/search/query"
str	api_key = "unset"
list	ads_field_list
int	ads_rows = 10
str	ads_sort = "read_count desc"

Detailed Description

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 ADS_ is a solr instance, but not with
the standard API paths.

.. note::

   The ADS_ engine requires an :py:obj:`API key <api_key>`.

This engine uses the `search/query`_ API endpoint.  Since the user's search term
is passed through, the `search syntax`_ of ADS can be used (at least to some
extent).

.. _ADS: https://ui.adsabs.harvard.edu
.. _search/query: https://ui.adsabs.harvard.edu/help/api/api-docs.html#get-/search/query
.. _search syntax: https://ui.adsabs.harvard.edu/help/search/search-syntax


Configuration
=============

The engine has the following additional settings:

- :py:obj:`api_key`
- :py:obj:`ads_sort`

.. code:: yaml

  - name: astrophysics data system
    api_key: "..."
    inactive: false


Implementations
===============

Function Documentation

◆ request()

None searx.engines.astrophysics_data_system.request	(	str	query,
		"OnlineParams"	params )

Definition at line 110 of file astrophysics_data_system.py.

def request(query: str, params: "OnlineParams") -> None:
 
    args: dict[str, str | int] = {
        "q": query,
        "fl": ",".join(ads_field_list),
        "rows": ads_rows,
        "start": ads_rows * (params["pageno"] - 1),
    }
    if ads_sort:
        args["sort"] = ads_sort
 
    params["headers"]["Authorization"] = f"Bearer {api_key}"
    params["url"] = f"{base_url}?{urlencode(args)}"
 
 

◆ response()

EngineResults searx.engines.astrophysics_data_system.response ( "SXNG_Response" resp )

Definition at line 125 of file astrophysics_data_system.py.

def response(resp: "SXNG_Response") -> EngineResults:
 
    res = EngineResults()
    json_data: dict[str, dict[str, t.Any]] = resp.json()
 
    if "error" in json_data:
        raise SearxEngineAPIException(json_data["error"]["msg"])
 
    def _str(k: str) -> str:
        return str(doc.get(k, ""))
 
    def _list(k: str) -> list[str]:
        return doc.get(k, [])
 
    for doc in json_data["response"]["docs"]:
        authors: list[str] = doc["author"]
        if len(authors) > 15:
            # There are articles with hundreds of authors
            authors = authors[:15] + ["et al."]
 
        paper = res.types.Paper(
            url=f"https://ui.adsabs.harvard.edu/abs/{doc.get('bibcode')}/",
            title=html_to_text(_list("title")[0]),
            authors=authors,
            content=html_to_text(_str("abstract")),
            doi=_list("doi")[0],
            issn=_list("issn"),
            isbn=_list("isbn"),
            tags=_list("keyword"),
            pages=",".join(_list("page")),
            publisher=_str("pub") + " " + _str("year"),
            publishedDate=datetime.fromisoformat(_str("date")),
            volume=_str("volume"),
            views=_str("read_count"),
            comments=" / ".join(_list("pubnote")),
        )
        res.add(paper)
 
    return res

◆ setup()

bool searx.engines.astrophysics_data_system.setup ( dict[str, t.Any] engine_settings )

Initialization of the ADS_ engine, checks whether the :py:obj:`api_key`
is set, otherwise the engine is inactive.

Definition at line 99 of file astrophysics_data_system.py.

def setup(engine_settings: dict[str, t.Any]) -> bool:
    """Initialization of the ADS_ engine, checks whether the :py:obj:`api_key`
    is set, otherwise the engine is inactive.
    """
    key: str = engine_settings.get("api_key", "")
    if key and key not in ("unset", "unknown", "..."):
        return True
    logger.error("Astrophysics Data System (ADS) API key is not set or invalid.")
    return False
 
 

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",
}

Definition at line 52 of file astrophysics_data_system.py.

◆ ads_field_list

list searx.engines.astrophysics_data_system.ads_field_list

Initial value:

=  [
    "abstract",
    "author",
    "bibcode",
    "comment",
    "date",
    "doi",
    "isbn",
    "issn",
    "keyword",
    "page",
    "page_count",
    "page_range",
    "pub",
    "pubdate",
    "pubnote",
    "read_count",
    "title",
    "volume",
    "year",
]