Búsqueda de películas, libros y podcasts con Python

Apple realmente no anuncia que iTunes Store y otros directorios tienen una API de búsqueda torcida pero simple, así que decidí escribir sobre eso. En esta publicación, aprenderá qué puede hacer la API y cómo usarla.

Buscar directorios de Apple

La API busca contenido en iTunes Store, iBooks Store, Apple Podcasts y App Store. En consecuencia, puede encontrar canciones, películas, libros, podcasts y aplicaciones.

API   JSONP,   Content-Type: text/javascript application/json.

GET /search?media=podcast&term=python HTTP/1.1
Host: itunes.apple.com
Accept: application/json

HTTP/2 200
content-type: text/javascript; charset=utf-8

{...}

, :

import requests

def search(term, media):
    url = "https://itunes.apple.com/search"
    payload = {"term": term, "media": media}
    response = requests.get(url, params=payload)
    response.raise_for_status()
    results = response.json().get("results", [])
    return results

>>> results = search("python", media="podcast")
>>> results[0]["collectionName"]
'Talk Python To Me'

:

• term — , ;
• media — (movie, podcast, music, audiobook, software, ebook, all),   all;
• country — , ISO- (us, ru, ...), us;
• limit — , 50.

, :

import requests

def search(term, media="all", country="us", limit=10):
    url = "https://itunes.apple.com/search"
    payload = {"term": term, "media": media, "country": country, "limit": limit}
    response = requests.get(url, params=payload)
    response.raise_for_status()
    results = response.json().get("results", [])
    return results

:

{
    "resultCount": 10,
    "results": [
        {
            "wrapperType": "track",
            "kind": "song",
            "artistId": 1495668306,
            "collectionId": 527039271,
            "trackId": 527039276,
            "artistName": "Dodge & Fuski",
            "collectionName": "Never Say Die (Deluxe Edition)",
            "trackName":"Python",
            ...
        }, 
        {
            "wrapperType": "track",
            "kind": "podcast",
            "collectionId": 979020229,
            "trackId": 979020229,
            "artistName": "Michael Kennedy (@mkennedy)",
            "collectionName": "Talk Python To Me"
            ...
        },
        ...
    ]
}

  (kind)    , . :

• artistId — ;
• artistName — ;
• artistViewUrl —  Apple;
• collectionId — ;
• collectionName —  ;
• collectionViewUrl —  Apple;
• trackId —  ;
• trackName —  ;
• artworkUrl100 — 100x100 ;
• country — ;
• primaryGenreName — .

   — podsearch,  .

 

(artistId, collectionId, trackId), lookup  :

import requests

def lookup(object_id):
    url = "https://itunes.apple.com/lookup"
    payload = {"id": object_id}
    response = requests.get(url, params=payload)
    response.raise_for_status()
    results = response.json().get("results", [])
    return results

>>> results = lookup(979020229)
>>> results[0]["collectionName"]
'Talk Python To Me'

Content-Type . :

• (country)   ,  .   ISO- (ru),   —  (RUS).
• El patrón de respuesta no existe.
• Apple limita la frecuencia de las llamadas a la API a 20 solicitudes por minuto.

Descripción de la API en el paquete de búsqueda de podcast del sitio web de Apple

Si quieres cosas más interesantes en Python, suscríbete al canal @ohmypy