Functions
	init (_)

	request (query, params)

	parse_image_item (item)

	parse_video_item (item)

	parse_audio_item (item)

	response (resp)

Variables
logging	logger .Logger

dict	about

list	categories = []

bool	paging = True

bool	send_accept_language_header = True

int	results_per_page = 10

str	base_url = "https://stock.adobe.com"

str	adobe_order = ""

list	ADOBE_VALID_TYPES = ["photo", "illustration", "zip_vector", "video", "template", "3d", "audio", "image"]

list	adobe_content_types = []

Detailed Description

`Adobe Stock`_ is a service that gives access to millions of royalty-free
assets. Assets types include photos, vectors, illustrations, templates, 3D
assets, videos, motion graphics templates and audio tracks.

.. Adobe Stock: https://stock.adobe.com/

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

The engine has the following mandatory setting:

- SearXNG's :ref:`engine categories`
- Adobe-Stock's :py:obj:`adobe_order`
- Adobe-Stock's :py:obj:`adobe_content_types`

.. code:: yaml

  - name: adobe stock
    engine: adobe_stock
    shortcut: asi
    categories: [images]
    adobe_order: relevance
    adobe_content_types: ["photo", "illustration", "zip_vector", "template", "3d", "image"]

  - name: adobe stock video
    engine: adobe_stock
    network: adobe stock
    shortcut: asi
    categories: [videos]
    adobe_order: relevance
    adobe_content_types: ["video"]

Implementation
==============

Function Documentation

◆ init()

searx.engines.adobe_stock.init ( _ )

Definition at line 96 of file adobe_stock.py.

def init(_):
    if not categories:
        raise ValueError("adobe_stock engine: categories is unset")
 
    # adobe_order
    if not adobe_order:
        raise ValueError("adobe_stock engine: adobe_order is unset")
    if adobe_order not in ["relevance", "featured", "creation", "nb_downloads"]:
        raise ValueError(f"unsupported adobe_order: {adobe_order}")
 
    # adobe_content_types
    if not adobe_content_types:
        raise ValueError("adobe_stock engine: adobe_content_types is unset")
 
    if isinstance(adobe_content_types, list):
        for t in adobe_content_types:
            if t not in ADOBE_VALID_TYPES:
                raise ValueError("adobe_stock engine: adobe_content_types: '%s' is invalid" % t)
    else:
        raise ValueError(
            "adobe_stock engine: adobe_content_types must be a list of strings not %s" % type(adobe_content_types)
        )
 
 

◆ parse_audio_item()

searx.engines.adobe_stock.parse_audio_item ( item )

Definition at line 192 of file adobe_stock.py.

def parse_audio_item(item):
    audio_data = item["audio_data"]
    content = audio_data.get("description") or ""
    if audio_data.get("album"):
        content = audio_data["album"] + " - " + content
 
    return {
        "url": item["content_url"],
        "title": item["title"],
        "content": content,
        # "thumbnail": base_url + item["thumbnail_url"],
        "iframe_src": audio_data["preview"]["url"],
        "publishedDate": datetime.fromisoformat(audio_data["release_date"]) if audio_data["release_date"] else None,
        "length": timedelta(seconds=round(audio_data["duration"] / 1000)) if audio_data["duration"] else None,
        "author": item.get("artist_name"),
    }
 
 

Referenced by searx.engines.adobe_stock.response().

Here is the caller graph for this function:

◆ parse_image_item()

searx.engines.adobe_stock.parse_image_item ( item )

Definition at line 142 of file adobe_stock.py.

def parse_image_item(item):
    return {
        "template": "images.html",
        "url": item["content_url"],
        "title": item["title"],
        "content": item["asset_type"],
        "img_src": item["content_thumb_extra_large_url"],
        "thumbnail_src": item["thumbnail_url"],
        "resolution": f"{item['content_original_width']}x{item['content_original_height']}",
        "img_format": item["format"],
        "author": item["author"],
    }
 
 

Referenced by searx.engines.adobe_stock.response().

Here is the caller graph for this function:

◆ parse_video_item()

searx.engines.adobe_stock.parse_video_item ( item )

Definition at line 156 of file adobe_stock.py.

def parse_video_item(item):
 
    # in video items, the title is more or less a "content description", we try
    # to reduce the lenght of the title ..
 
    title = item["title"]
    content = ""
    if "." in title.strip()[:-1]:
        content = title
        title = title.split(".", 1)[0]
    elif "," in title:
        content = title
        title = title.split(",", 1)[0]
    elif len(title) > 50:
        content = title
        title = ""
        for w in content.split(" "):
            title += f" {w}"
            if len(title) > 50:
                title = title.strip() + "\u2026"
                break
 
    return {
        "template": "videos.html",
        "url": item["content_url"],
        "title": title,
        "content": content,
        # https://en.wikipedia.org/wiki/ISO_8601#Durations
        "length": isodate.parse_duration(item["time_duration"]),
        "publishedDate": datetime.strptime(item["creation_date"], "%Y-%m-%d"),
        "thumbnail": item["thumbnail_url"],
        "iframe_src": item["video_small_preview_url"],
        "metadata": item["asset_type"],
    }
 
 

Referenced by searx.engines.adobe_stock.response().

Here is the caller graph for this function:

◆ request()

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

Definition at line 120 of file adobe_stock.py.

def request(query, params):
 
    args = {
        "k": query,
        "limit": results_per_page,
        "order": adobe_order,
        "search_page": params["pageno"],
        "search_type": "pagination",
    }
 
    for content_type in ADOBE_VALID_TYPES:
        args[f"filters[content_type:{content_type}]"] = 1 if content_type in adobe_content_types else 0
 
    params["url"] = f"{base_url}/de/Ajax/Search?{urlencode(args)}"
 
    # headers required to bypass bot-detection
    if params["searxng_locale"] == "all":
        params["headers"]["Accept-Language"] = "en-US,en;q=0.5"
 
    return params
 
 

◆ response()

searx.engines.adobe_stock.response ( resp )

Definition at line 210 of file adobe_stock.py.

def response(resp):
    results = []
 
    json_resp = resp.json()
 
    if isinstance(json_resp["items"], list):
        return None
    for item in json_resp["items"].values():
        if item["asset_type"].lower() in ["image", "premium-image", "illustration", "vector"]:
            result = parse_image_item(item)
        elif item["asset_type"].lower() == "video":
            result = parse_video_item(item)
        elif item["asset_type"].lower() == "audio":
            result = parse_audio_item(item)
        else:
            logger.error("no handle for %s --> %s", item["asset_type"], item)
            continue
        results.append(result)
 
    return results

References searx.engines.adobe_stock.parse_audio_item(), searx.engines.adobe_stock.parse_image_item(), and searx.engines.adobe_stock.parse_video_item().

Here is the call graph for this function:

Variable Documentation

◆ about

dict searx.engines.adobe_stock.about

Initial value:

=  {
    "website": "https://stock.adobe.com/",
    "wikidata_id": "Q5977430",
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": False,
    "results": "JSON",
}

Definition at line 51 of file adobe_stock.py.

◆ adobe_content_types

list searx.engines.adobe_stock.adobe_content_types = []

Definition at line 77 of file adobe_stock.py.

◆ adobe_order

str searx.engines.adobe_stock.adobe_order = ""

Definition at line 67 of file adobe_stock.py.

◆ ADOBE_VALID_TYPES

list searx.engines.adobe_stock.ADOBE_VALID_TYPES = ["photo", "illustration", "zip_vector", "video", "template", "3d", "audio", "image"]

Definition at line 76 of file adobe_stock.py.

◆ base_url

str searx.engines.adobe_stock.base_url = "https://stock.adobe.com"

Definition at line 65 of file adobe_stock.py.

◆ categories

list searx.engines.adobe_stock.categories = []

Definition at line 60 of file adobe_stock.py.

◆ logger

logging searx.engines.adobe_stock.logger .Logger

Definition at line 49 of file adobe_stock.py.

◆ paging

bool searx.engines.adobe_stock.paging = True

Definition at line 61 of file adobe_stock.py.

◆ results_per_page

int searx.engines.adobe_stock.results_per_page = 10

Definition at line 63 of file adobe_stock.py.

◆ send_accept_language_header

bool searx.engines.adobe_stock.send_accept_language_header = True

Definition at line 62 of file adobe_stock.py.

Functions

Variables

Detailed Description

Function Documentation

◆ init()

◆ parse_audio_item()

◆ parse_image_item()

◆ parse_video_item()

◆ request()

◆ response()

Variable Documentation

◆ about

◆ adobe_content_types

◆ adobe_order

◆ ADOBE_VALID_TYPES

◆ base_url

◆ categories

◆ logger

◆ paging

◆ results_per_page

◆ send_accept_language_header