apple_app_store.py

Go to the documentation of this file.

# SPDX-License-Identifier: AGPL-3.0-or-later
"""Apple App Store
 
"""
 
from json import loads
from urllib.parse import urlencode
from dateutil.parser import parse
 
about = {
    "website": 'https://www.apple.com/app-store/',
    "wikidata_id": 'Q368215',
    "official_api_documentation": (
        'https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/'
        'iTuneSearchAPI/UnderstandingSearchResults.html#//apple_ref/doc/uid/TP40017632-CH8-SW1'
    ),
    "use_official_api": True,
    "require_api_key": False,
    "results": 'JSON',
}
 
categories = ['files', 'apps']
safesearch = True
 
search_url = 'https://itunes.apple.com/search?{query}'
 
 
def request(query, params):
    explicit = "Yes"
 
    if params['safesearch'] > 0:
        explicit = "No"
 
    params['url'] = search_url.format(query=urlencode({'term': query, 'media': 'software', 'explicit': explicit}))
 
    return params
 
 
def response(resp):
    results = []
 
    json_result = loads(resp.text)
 
    for result in json_result['results']:
        results.append(
            {
                'url': result['trackViewUrl'],
                'title': result['trackName'],
                'content': result['description'],
                'thumbnail': result['artworkUrl100'],
                'publishedDate': parse(result['currentVersionReleaseDate']),
                'author': result['sellerName'],
            }
        )
 
    return results