---

Warning

This post is more than a year old. Information may be outdated.

Recently I came across The Noun Project's API. With the combination of the download function I created in the past, you could download hundreds of icons within seconds.

Beware

Do not use this tool to pirate others' intellectual property. Beware of what you are doing with this code and The Noun Project's API. Read the license and API documents thoroughly. Unauthorized use cases are listed here. This entire post & codes are MIT licensed.

Importing libraries

You will need to pip3 download if you do not have these libraries.

The `download` function

python

def download(url, pathname):    if not os.path.isdir(pathname):        os.makedirs(pathname)    response = requests.get(url, stream=True)    file_size = int(response.headers.get("Content-Length", 0))    filename = os.path.join(pathname, url.split("/")[-1])    if filename.find("?") > 0:        filename = filename.split("?")[0]    progress = tqdm(        response.iter_content(256),        f"Downloading {filename}",        total=file_size,        unit="B",        unit_scale=True,        unit_divisor=1024,    )    with open(filename, "wb") as f:        for data in progress:            f.write(data)            progress.update(len(data))

def download(url, pathname):    if not os.path.isdir(pathname):        os.makedirs(pathname)    response = requests.get(url, stream=True)    file_size = int(response.headers.get("Content-Length", 0))    filename = os.path.join(pathname, url.split("/")[-1])    if filename.find("?") > 0:        filename = filename.split("?")[0]    progress = tqdm(        response.iter_content(256),        f"Downloading {filename}",        total=file_size,        unit="B",        unit_scale=True,        unit_divisor=1024,    )    with open(filename, "wb") as f:        for data in progress:            f.write(data)            progress.update(len(data))

This code fetches the URL and saves it as a file at pathname.

The Noun Project API

python

# ---
DOWNLOAD_ITERATION = 3# Returns 50 icons per iteration.# Three iteration equals 150 icons.
SEARCH_KEY = "tree"  # Search TermSAVE_LOCATION = "./icons"auth = OAuth1("API_KEY", "API_SECRET")
# ---
for iteration in range(DOWNLOAD_ITERATION):    endpoint = (        "http://api.thenounproject.com/icons/"        + SEARCH_KEY        + "?offset="        + str(iteration * 50)    )    response = requests.get(endpoint, auth=auth).json()    for icon in response["icons"]:        download(icon["preview_url"], SAVE_LOCATION)

# ---
DOWNLOAD_ITERATION = 3# Returns 50 icons per iteration.# Three iteration equals 150 icons.
SEARCH_KEY = "tree"  # Search TermSAVE_LOCATION = "./icons"auth = OAuth1("API_KEY", "API_SECRET")
# ---
for iteration in range(DOWNLOAD_ITERATION):    endpoint = (        "http://api.thenounproject.com/icons/"        + SEARCH_KEY        + "?offset="        + str(iteration * 50)    )    response = requests.get(endpoint, auth=auth).json()    for icon in response["icons"]:        download(icon["preview_url"], SAVE_LOCATION)

For more advanced uses, please visit this docs page. In addition, you can get your API Key and API secret by registering your app here.

Result

I have run some benchmarks and found that downloading ~5k icons shouldn't be a problem. However, The Noun Project's API has a call limit so beware of that.

Backlinks (0)

No backlinks found.

Comments (0)

---

Beware

Importing libraries

The download function

The Noun Project API

Result

The `download` function