API di MeetUp

MeetUp è un social network che permette ai membri di creare community virtuali che organizzano eventi nella propria area geografica. Il concetto alla base di MeetUp non è nuovo, ma l’UI e la UX sono state tra le più innovative degli ultimi anni. Snellire i compiti di organizzazione di eventi specifici per una community che si incontra ogni giorno, ogni settimana, ogni mese o ogni due mesi è diventato più semplice.

L’API di MeetUp consente agli utenti di raccogliere dati direttamente dal sito. Come la maggior parte delle API, molti proprietari di domini limitano la quantità di dati che puoi richiedere. Alcuni domini non fanno un ottimo lavoro nel mantenere aggiornata la documentazione della loro API. Altri invece fanno un lavoro eccezionale nel renderla il più user friendly possibile. MeetUp si colloca nel mezzo. Ci sono molti modi in cui puoi usare la loro API.

Il mio uso dell’API di MeetUp è stato quello di raccogliere dati da tre diversi gruppi nell’area di Dallas–Fort Worth, nel Nord del Texas. Il linguaggio che ho usato per accedere all’API sul dominio di MeetUp è stato Python. A seconda di ciò con cui ti senti a tuo agio, C++ o Python possono bastare per usare l’API di un sito.

Se non hai ancora familiarità con Python, dai un’occhiata al nostro corso Introduzione a Python per Data Science.

In questo tutorial imparerai come chiamare l’API di MeetUp usando Python. Ti mostrerò come puoi ottenere l’ID di un gruppo e come usare quell’ID insieme alla tua API Key per effettuare una richiesta dei dati di un gruppo in formato JSON. Infine, ti mostrerò come puoi scrivere i dati acquisiti in un file JSON che verrà salvato sul tuo PC/Mac.

Come ottenere una API Key?

Sul sito di MeetUp devi avere un account attivo per ottenere una API key. Tutti gli utenti del sito ricevono una chiave. Per chi non ha un account, il primo passo è registrarsi su MeetUp. Una volta completata la registrazione, puoi ottenere la tua API key qui.

Hai la possibilità di reimpostare la tua chiave in qualsiasi momento. È importante mantenere riservata la tua API key.

Per iniziare

Per prima cosa, importa tutte le librerie Python che userai nel tuo semplice script py.

import meetup.api
import json
import requests
import time
import codecs
import sys
import io

Installare l’API

Assicurati che meetup.api sia installato sulla tua macchina prima di procedere con l’esecuzione di questo input. Se usi un prompt dei comandi basato su UNIX, è sufficiente una semplice installazione con pip come segue:

pip install meetup.api

Se usi Jupyter Notebook, puoi installare la libreria così:

!pip install meetup.api

Questo installerà la libreria dell’API di MeetUp per Python.

Poiché Python è un linguaggio interpretato, le definizioni giocano un ruolo importante nella sintassi. Ad esempio, definendo client puoi scrivere qualsiasi richiesta e usare semplicemente il termine client per richiamare la API key, senza doverla digitare continuamente. Questo è un aspetto importante nel programmare in Python. Per prima cosa, definirai la tua API key come client come segue:

client = meetup.api.Client('API Key Here')

Definire group_info ti permette di recuperare l’URL di un gruppo in base al nome del gruppo sul sito di MeetUp.

group_info = client.GetGroup({'urlname': 'Group Name Here No Spaces'})

Ottenere l’ID di un gruppo

Una volta fatto, puoi chiamare group_info ed effettuare diverse richieste. Digitando la riga group_info.link l’output sarà l’indirizzo URL completo del gruppo.

group_info.link

Chiamando group_info.id nella riga successiva otterrai il numero ID del gruppo.

group_info.id

ti serve il numero ID del gruppo per poter procedere con il prossimo passaggio.

Effettuare richieste

Ora conosci il numero ID del tuo gruppo. Puoi eseguire la richiesta definendo df e inserendo l’ID del gruppo e la tua API key nell’URL. Questo è chiamato un request.get

df = requests.get('https://api.meetup.com/2/members?group_id=GROUP_ID&key=API_KEY')

Con df definito, ora puoi richiamare lo status_code, gli header, la codifica e puoi visualizzare direttamente i dati chiamando il JSON.

Per prima cosa digita df.status_code; l’output per status_code dovrebbe essere: 200

Per gli header digita df.headers['content-type'] Output per gli header: application/json;charset=utf-8

Per verificare la codifica digita df.encoding Output per la codifica: utf-8

A questo punto, i tuoi dati definiti come df esistono. Per vederli inline digita df.json()

Scrivere i dati in un file JSON

A questo punto hai i dati. Il passo successivo è scriverli in un file JSON che si salverà sul tuo PC/MAC. Questo è un passaggio importante. Hai già i dati, ma non sono salvati sul tuo disco locale. Puoi usare il seguente codice per scrivere i dati in un file.

try:
 to_unicode = unicode
except NameError:
 to_unicode = str
with io.open('df.json', 'w', encoding='utf8') as outfile:
 str_ = json.dumps(data,
 indent=4, sort_keys=True,
 separators=(',', ': '), ensure_ascii=False)
 outfile.write(to_unicode(str_))

Prima di eseguirlo, importa la libreria io con import io.

Nel momento in cui esegui questo codice, scriverà i dati dalla richiesta che hai effettuato usando l’API di MeetUp in un file JSON salvato nella directory del tuo hard disk. In particolare, nella stessa directory del file .ipynb o .py che stai usando.

Se usi Jupyter Notebook, dovresti riuscire a trovarlo subito se organizzi la tua directory in Jupyter Notebook in ordine di ultima modifica. Sentiti libero di salvarlo in una posizione più comoda per usi futuri.

A cosa serve il file JSON? Il file JSON contiene i dati che hai estratto usando l’API di MeetUp. Puoi usare questi dati in vari modi. Se i dati hanno valori mancanti, puoi usare Python per ripulirli. Puoi costruire un dataset e applicare numerose tecniche per fare Data Analysis. Oppure puoi visualizzare i dati e creare dashboard e grafici che mostrino correlazioni nel dataset. Infine, un buon dataset può essere usato per applicare algoritmi di Machine Learning e costruire un modello predittivo. Queste sono solo alcune delle cose che puoi fare con il file JSON che abbiamo scritto dall’API di MeetUp. L’unico limite è la tua immaginazione. In conclusione, estrarre dati dall’API di un sito è uno dei tanti modi per ottenere dataset. L’obiettivo finale è mettere il dataset a frutto in analisi dei dati, modellazione e visualizzazione.

Conclusione

In conclusione, usare l’API di MeetUp per estrarre dati richiede diversi passaggi. Il primo è trovare e identificare la tua API Key, il successivo è ottenere l’ID del gruppo desiderato. Con queste informazioni puoi estrarre dati da qualsiasi gruppo tu voglia. Una volta effettuata la richiesta, dovrai scriverla in un file JSON. Sapere come usare le API come strumento è un modo utile ed economico per raccogliere dati. Stai raccogliendo dati con cui potrai lavorare in progetti futuri. Usare l’API di un sito è spesso la metodologia meno intrusiva rispetto ad altri metodi come lo scraping dei dati. Una volta che hai un file JSON, c’è comunque del lavoro da fare. Dovrai comunque pulire i dati. Da principiante dovrai capire cosa significa pulire i dati. Pulire i dati significa organizzare un dataset in modo che le colonne e le righe di un dataset non siano mancanti. Esaminerai i dati numerici mancanti e i dati categoriali (nomi, località, ecc.). Ora hai gli strumenti per iniziare a estrarre dati dall’API di MeetUp.

Prima di poter iniziare a lavorare con i dati richiesti da un’API, dovrai pulirli. Se vuoi imparare come fare, segui il nostro corso Cleaning Data in Python.

Quando usi l’API di un sito, tieni presente i limiti imposti sull’utilizzo di un’API. I proprietari dei domini stabiliscono queste regole. Esercita autoconsapevolezza e sii coscienzioso.

Dai un’occhiata al nostro tutorial Guida per principianti alla Vision API di Google in Python.