duolingo_data.py

#File: duolingo_data.py
#Author: Mercury
#Description: A script for data collection on Duolingo users using

#Importing the necessary libraries
import datetime, requests, pycountry, argparse
from iso639 import languages

#Sorting out the important parameters
ENDPOINT_MAIL = "https://www.duolingo.com/2017-06-30/users?email="
ENDPOINT_USERNAME = "https://www.duolingo.com/2017-06-30/users?username="
USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36"

def call_by_username(username):
    return requests.get(ENDPOINT_USERNAME + username, 
                        headers={"User-Agent": USER_AGENT}).json()

def call_by_mail(mail):
    return requests.get(ENDPOINT_MAIL +  mail, 
                        headers={"User-Agent": USER_AGENT}).json()

#Data collection engine
if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    group = parser.add_mutually_exclusive_group(required=True)
    group.add_argument('-m', '--mail',
                       help="Target mail address",
                       required=False)
    group.add_argument('-u', '--username',
                       help="Target Duolingo username",
                       required=False)
    args = parser.parse_args()
    if args.mail is None:
        response = call_by_username(args.username)
    else:
        response = call_by_mail(args.mail)
    usercount = len(response["users"])
    match usercount:
        case 0:
            print("Couldn't find any users with the given information.")
            exit(0)
        case 1:
            print("Found 1 user with the given information.")
        case _:
            print("Found multiple (", str(usercount), ") users with the given information.")
    for user in response["users"]:
        print("Informations about     : ", user["username"])
        if "name" in user:
            print("Name                   : ", user["name"])
        print("Has Google ID?         : ", user["hasGoogleId"])
        print("Has Facebook ID?       : ", user["hasFacebookId"])
        print("Email Verification     : ", user["emailVerified"])
        print("Profile picture        : ", 
              "https:", user["picture"], "/xxlarge")
        print("Account Creation Date  : ", 
              str(datetime.datetime.fromtimestamp(user["creationDate"])))
        if user["profileCountry"] is not None:
            print("Country                : ",
                  pycountry.countries.get(alpha_2=user["profileCountry"]).name)
        print("Streak                 : ", str(user["streak"]))
        print("Has recent activity    : ", str(user["hasRecentActivity15"]))
        if user["bio"] != "":
            print("Biography              : ", user["bio"])
        print("Languages studied      : ")
        for course in user["courses"]:
            print(" + ", course["title"], ' (from ',
                  languages.get(alpha2=course["fromLanguage"]).name,')')