Functions
	request (query, params)

	response (resp)

Variables
dict	about

bool	paging = True

bool	time_range_support = True

list	categories = ["it"]

int	results_per_page = 30

str	base_url = "https://hn.algolia.com/api/v1"

Detailed Description

Hackernews

Function Documentation

◆ request()

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

Definition at line 31 of file hackernews.py.

def request(query, params):
    search_type = 'search'
    if not query:
        # if search query is empty show results from HN's front page
        search_type = 'search_by_date'
        query_params = {
            "tags": "front_page",
            "page": (params["pageno"] - 1),
        }
    else:
        query_params = {
            "query": query,
            "page": (params["pageno"] - 1),
            "hitsPerPage": results_per_page,
            "minWordSizefor1Typo": 4,
            "minWordSizefor2Typos": 8,
            "advancedSyntax": "true",
            "ignorePlurals": "false",
            "minProximity": 7,
            "numericFilters": '[]',
            "tagFilters": '["story",[]]',
            "typoTolerance": "true",
            "queryType": "prefixLast",
            "restrictSearchableAttributes": '["title","comment_text","url","story_text","author"]',
            "getRankingInfo": "true",
        }
 
        if params['time_range']:
            search_type = 'search_by_date'
            timestamp = (datetime.now() - relativedelta(**{f"{params['time_range']}s": 1})).timestamp()
            query_params["numericFilters"] = f"created_at_i>{timestamp}"
 
    params["url"] = f"{base_url}/{search_type}?{urlencode(query_params)}"
    return params
 
 

◆ response()

searx.engines.hackernews.response ( resp )

Definition at line 67 of file hackernews.py.

def response(resp):
    results = []
    data = resp.json()
 
    for hit in data["hits"]:
        object_id = hit["objectID"]
        points = hit.get("points") or 0
        num_comments = hit.get("num_comments") or 0
 
        metadata = ""
        if points != 0 or num_comments != 0:
            metadata = f"{gettext('points')}: {points}" f" | {gettext('comments')}: {num_comments}"
        results.append(
            {
                "title": hit.get("title") or f"{gettext('author')}: {hit['author']}",
                "url": f"https://news.ycombinator.com/item?id={object_id}",
                "content": hit.get("url") or hit.get("comment_text") or hit.get("story_text") or "",
                "metadata": metadata,
                "author": hit["author"],
                "publishedDate": datetime.utcfromtimestamp(hit["created_at_i"]),
            }
        )
 
    return results

Variable Documentation

◆ about

dict searx.engines.hackernews.about

Initial value:

=  {
    "website": "https://news.ycombinator.com/",
    "wikidata_id": "Q686797",
    "official_api_documentation": "https://hn.algolia.com/api",
    "use_official_api": True,
    "require_api_key": False,
    "results": "JSON",
}

Definition at line 12 of file hackernews.py.

◆ base_url

str searx.engines.hackernews.base_url = "https://hn.algolia.com/api/v1"

Definition at line 28 of file hackernews.py.

◆ categories

list searx.engines.hackernews.categories = ["it"]

Definition at line 24 of file hackernews.py.

◆ paging

bool searx.engines.hackernews.paging = True

Definition at line 22 of file hackernews.py.

◆ results_per_page

int searx.engines.hackernews.results_per_page = 30

Definition at line 25 of file hackernews.py.

◆ time_range_support

bool searx.engines.hackernews.time_range_support = True

Definition at line 23 of file hackernews.py.

Functions

Variables