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


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 in general. Read the license and API documents thoroughly. Unauthorized use cases are listed here. This entire post & codes are MIT licensed.

Importing libraries

import requests
import os
from tqdm import tqdm
from requests_oauthlib import OAuth1

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

The download function

def download(url, pathname):
    if not os.path.isdir(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(
        f"Downloading {filename}",
    with open(filename, "wb") as f:
        for data in progress:

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

The Noun Project API

# ---

# Returns 50 icons per iteration.
# Three iteration equals 150 icons.

SEARCH_KEY = "tree"  # Search Term
SAVE_LOCATION = "./icons"
auth = OAuth1("API_KEY", "API_SECRET")

# ---

for iteration in range(DOWNLOAD_ITERATION):
    endpoint = (
        + 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. You can get your API Key and API secret by registering your app here.


I have ran 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.

You’ve successfully subscribed to Sunghyun Cho
Welcome back! You’ve successfully signed in.
Great! You’ve successfully signed up.
Your link has expired
Success! Check your email for magic link to sign-in.