Pesquisando filmes, livros e podcasts usando Python

A Apple realmente não anuncia que a iTunes Store e outros diretórios têm uma API de pesquisa simples, mas excêntrica - então decidi escrever sobre isso. Nesta postagem, você aprenderá o que a API pode fazer e como usá-la.

Pesquisar diretórios da Apple

A API pesquisa o conteúdo da iTunes Store, iBooks Store, Apple Podcasts e App Store. Assim, você pode encontrar músicas, filmes, livros, podcasts e aplicativos.

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).
• Não há padrão de resposta.
• A Apple limita a frequência das chamadas de API a 20 solicitações por minuto.

Descrição da API no pacote de pesquisa Podcast do site da Apple

Se você quiser coisas mais interessantes em Python, assine o canal @ohmypy