Functions
	request (query, params)
	response (resp)
	init (engine_settings)
str\|None	get_client_id ()

Variables
dict	about
list	categories = ["music"]
bool	paging = True
str	search_url = "https://api-v2.soundcloud.com/search"
	cid_re = re.compile(r'client_id:"([^"]*)"', re.I \| re.U)
int	results_per_page = 10
str	soundcloud_facet = "model"
dict	app_locale_map

Detailed Description

SoundCloud is a German audio streaming service.

Function Documentation

◆ get_client_id()

str | None searx.engines.soundcloud.get_client_id ( )

Definition at line 123 of file soundcloud.py.

def get_client_id() -> str | None:
 
    client_id = ""
    url = "https://soundcloud.com"
    resp = http_get(url, timeout=10)
 
    if not resp.ok:
        logger.error("init: GET %s failed", url)
        return client_id
 
    tree = html.fromstring(resp.content)
    script_tags = tree.xpath("//script[contains(@src, '/assets/')]")
    app_js_urls = [tag.get("src") for tag in script_tags if tag is not None]
 
    # extracts valid app_js urls from soundcloud.com content
 
    for url in app_js_urls[::-1]:
 
        # gets app_js and search for the client_id
        resp = http_get(url)
 
        if not resp.ok:
            logger.error("init: app_js GET %s failed", url)
            continue
 
        cids = cid_re.search(resp.content.decode())
        if cids and len(cids.groups()):
            client_id = cids.groups()[0]
            break
 
    if client_id:
        logger.info("using client_id '%s' for soundclud queries", client_id)
    else:
        logger.warning("missing valid client_id for soundclud queries")
    return client_id or None

Referenced by request().

Here is the caller graph for this function:

◆ init()

searx.engines.soundcloud.init ( engine_settings )

Definition at line 118 of file soundcloud.py.

def init(engine_settings):  # pylint: disable=unused-argument
    global CACHE  # pylint: disable=global-statement
    CACHE = EngineCache(engine_settings["name"])  # type:ignore
 
 

◆ request()

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

Definition at line 57 of file soundcloud.py.

def request(query, params):
 
    # missing attributes: user_id, app_version
    # - user_id=451561-497874-703312-310156
    # - app_version=1740727428
 
    guest_client_id = CACHE.get("guest_client_id")
    if guest_client_id is None:
        guest_client_id = get_client_id()
        if guest_client_id:
            CACHE.set(key="guest_client_id", value=guest_client_id)
 
    args = {
        "q": query,
        "offset": (params['pageno'] - 1) * results_per_page,
        "limit": results_per_page,
        "facet": soundcloud_facet,
        "client_id": guest_client_id,
        "app_locale": app_locale_map.get(params["language"].split("-")[0], "en"),
    }
 
    params['url'] = f"{search_url}?{urlencode(args)}"
    return params
 
 

References get_client_id().

Here is the call graph for this function:

◆ response()

searx.engines.soundcloud.response ( resp )

Definition at line 82 of file soundcloud.py.

def response(resp):
    results = []
    data = resp.json()
 
    for result in data.get("collection", []):
 
        if result["kind"] in ("track", "playlist"):
            url = result.get("permalink_url")
            if not url:
                continue
            uri = quote_plus(result.get("uri"))
            content = [
                result.get("description"),
                result.get("label_name"),
            ]
            res = {
                "url": url,
                "title": result["title"],
                "content": " / ".join([c for c in content if c]),
                "publishedDate": parser.parse(result["last_modified"]),
                "iframe_src": "https://w.soundcloud.com/player/?url=" + uri,
                "views": result.get("likes_count"),
            }
            thumbnail = result["artwork_url"] or result["user"]["avatar_url"]
            res["thumbnail"] = thumbnail or None
            length = int(result.get("duration", 0) / 1000)
            if length:
                length = datetime.timedelta(seconds=length)
                res["length"] = length
            res["views"] = result.get("playback_count", 0) or None
            res["author"] = result.get("user", {}).get("full_name") or None
            results.append(res)
 
    return results
 
 

Variable Documentation

◆ about

dict searx.engines.soundcloud.about

Initial value:

=  {
    "website": "https://soundcloud.com",
    "wikidata_id": "Q568769",
    "official_api_documentation": "https://developers.soundcloud.com/docs/api/guide",
    "use_official_api": False,
    "require_api_key": False,
    "results": 'JSON',
}

Definition at line 15 of file soundcloud.py.

◆ app_locale_map

dict searx.engines.soundcloud.app_locale_map

Initial value:

=  {
    "de": "de",
    "en": "en",
    "es": "es",
    "fr": "fr",
    "oc": "fr",
    "it": "it",
    "nl": "nl",
    "pl": "pl",
    "szl": "pl",
    "pt": "pt_BR",
    "pap": "pt_BR",
    "sv": "sv",
}

Definition at line 37 of file soundcloud.py.

◆ categories

list searx.engines.soundcloud.categories = ["music"]

Definition at line 24 of file soundcloud.py.

◆ cid_re

searx.engines.soundcloud.cid_re = re.compile(r'client_id:"([^"]*)"', re.I | re.U)

Definition at line 32 of file soundcloud.py.

◆ paging

bool searx.engines.soundcloud.paging = True

Definition at line 25 of file soundcloud.py.

◆ results_per_page

int searx.engines.soundcloud.results_per_page = 10

Definition at line 33 of file soundcloud.py.

◆ search_url

str searx.engines.soundcloud.search_url = "https://api-v2.soundcloud.com/search"

Definition at line 27 of file soundcloud.py.

◆ soundcloud_facet

str searx.engines.soundcloud.soundcloud_facet = "model"

Definition at line 35 of file soundcloud.py.

Functions

Variables