Functions
	request (query, params)

	response (resp)

Variables
dict	about

list	categories = ['music']

bool	paging = True

str	base_url = "https://bandcamp.com/"

str	search_string = 'search?{query}&page={page}'

str	iframe_src = "https://bandcamp.com/EmbeddedPlayer/{type}={result_id}/size=large/bgcol=000/linkcol=fff/artwork=small"

Detailed Description

Bandcamp (Music)

@website     https://bandcamp.com/
@provide-api no
@results     HTML
@parse       url, title, content, publishedDate, iframe_src, thumbnail

Function Documentation

◆ request()

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

Definition at line 39 of file bandcamp.py.

def request(query, params):
 
    search_path = search_string.format(query=urlencode({'q': query}), page=params['pageno'])
    params['url'] = base_url + search_path
    return params

◆ response()

searx.engines.bandcamp.response ( resp )

Definition at line 46 of file bandcamp.py.

def response(resp):
 
    results = []
    dom = html.fromstring(resp.text)
 
    for result in eval_xpath_list(dom, '//li[contains(@class, "searchresult")]'):
 
        link = eval_xpath_getindex(result, './/div[@class="itemurl"]/a', 0, default=None)
        if link is None:
            continue
 
        title = result.xpath('.//div[@class="heading"]/a/text()')
        content = result.xpath('.//div[@class="subhead"]/text()')
        new_result = {
            "url": extract_text(link),
            "title": extract_text(title),
            "content": extract_text(content),
        }
 
        date = eval_xpath_getindex(result, '//div[@class="released"]/text()', 0, default=None)
        if date:
            new_result["publishedDate"] = dateparse(date.replace("released ", ""))
 
        thumbnail = result.xpath('.//div[@class="art"]/img/@src')
        if thumbnail:
            new_result['thumbnail'] = thumbnail[0]
 
        result_id = parse_qs(urlparse(link.get('href')).query)["search_item_id"][0]
        itemtype = extract_text(result.xpath('.//div[@class="itemtype"]')).lower()
        if "album" == itemtype:
            new_result["iframe_src"] = iframe_src.format(type='album', result_id=result_id)
        elif "track" == itemtype:
            new_result["iframe_src"] = iframe_src.format(type='track', result_id=result_id)
 
        results.append(new_result)
    return results

Variable Documentation

◆ about

dict searx.engines.bandcamp.about

Initial value:

=  {
    "website": 'https://bandcamp.com/',
    "wikidata_id": 'Q545966',
    "official_api_documentation": 'https://bandcamp.com/developer',
    "use_official_api": False,
    "require_api_key": False,
    "results": 'HTML',
}

Definition at line 22 of file bandcamp.py.

◆ base_url

str searx.engines.bandcamp.base_url = "https://bandcamp.com/"

Definition at line 34 of file bandcamp.py.

◆ categories

list searx.engines.bandcamp.categories = ['music']

Definition at line 31 of file bandcamp.py.

◆ iframe_src

str searx.engines.bandcamp.iframe_src = "https://bandcamp.com/EmbeddedPlayer/{type}={result_id}/size=large/bgcol=000/linkcol=fff/artwork=small"

Definition at line 36 of file bandcamp.py.

◆ paging

bool searx.engines.bandcamp.paging = True

Definition at line 32 of file bandcamp.py.

◆ search_string

str searx.engines.bandcamp.search_string = 'search?{query}&page={page}'

Definition at line 35 of file bandcamp.py.

Functions

Variables