We're moving! Noun-API is now CloudNouns. Check back for updates soon!
Docs These docs are in progress and will be updated soon. If you have questions feel free to ping me on Twitter ! I’ll be updating the website with a better playground soon!
/pfp Options should be passed as query parameters . If no paramaters are provided, a random noun will be generated and returned as a 320px by 320px SVG image.
The base url is: https://noun-api.com/beta/pfp
Options Name providing a name will return the same noun every time. useful for name-based avatars
Traits you can specify (or override) traits for the noun with the appropriate param. a random trait will be provided if both name and the trait are not provided.
background body accessory head glasses Background random cool warm
Body random bege-bsod bege-crt blue-sky bluegrey cold computerblue darkbrown darkpink foggrey gold grayscale-1 grayscale-7 grayscale-8 grayscale-9 green gunk hotbrown magenta orange-yellow orange peachy-B peachy-a purple red redpinkish rust slimegreen teal-light teal yellow
Accessory random 1n aardvark axe belly-chameleon bird-flying bird-side bling-anchor bling-anvil bling-arrow bling-cheese bling-gold-ingot bling-love bling-mask bling-rings bling-scissors bling-sparkles gradient-checkerdisco gradient-dawn gradient-dusk gradient-glacier gradient-ice gradient-pride gradient-redpink gradient-sunset carrot chain-logo checker-RGB checker-bigwalk-blue-prime checker-bigwalk-greylight checker-bigwalk-rainbow checker-spaced-black checker-spaced-white checker-vibrant checkers-big-green checkers-big-red-cold checkers-black checkers-blue checkers-magenta-80 chicken cloud clover collar-sunset cow decay-gray-dark decay-pride dinosaur dollar-bling dragon ducky eth eye flash fries glasses-logo-sun glasses-logo glasses grid-simple-bege heart hoodiestrings-uneven id infinity insignia leaf lightbulb lines-45-greens lines-45-rose lp marsface matrix-white moon-block none oldshirt pizza-bling pocket-pencil rain rainbow-steps rgb robot safety-vest scarf-clown secret-x shirt-black shrimp slimesplat small-bling snowflake stains-blood stains-zombie stripes-and-checks stripes-big-red stripes-blit stripes-blue-med stripes-brown stripes-olive stripes-red-cold sunset taxi-checkers tee-yo text-yolo think tie-black-on-white tie-dye tie-purple-on-white tie-red txt-a2+b2 txt-cc txt-cc2 txt-copy txt-dao-black txt-doom txt-dope-text txt-foo-black txt-ico txt-io txt-lmao txt-lol txt-mint txt-nil-grey-dark txt-noun-f0f txt-noun-green txt-noun-multicolor txt-noun txt-pi txt-pop txt-rofl txt-we txt-yay wall wave wet-money woolweave-bicolor woolweave-dirt yingyang body-bege body-gray-scale-1 body-gray-scale-9 body-ice-cold
Head random aardvark abstract ape bag bagpipe banana bank baseball-gameball basketball bat bear beer beet bell bigfoot-yeti bigfoot blackhole blueberry bomb bonsai boombox boot box boxingglove brain bubble-speech bubblegum burger-dollarmenu cake calculator calendar camcorder cannedham car cash-register cassettetape cat cd chain chainsaw chameleon chart-bars cheese chefhat cherry chicken chilli chipboard chips chocolate cloud clover clutch coffeebean cone console-handheld cookie cordlessphone cottonball cow crab crane croc-hat crown crt-bsod crystalball diamond-blue diamond-red dictionary dino dna dog doughnut drill duck ducky earth egg faberge factory-dark fan fence film-35mm film-strip fir firehydrant flamingo flower fox frog garlic gavel ghost-B glasses-big gnome goat goldcoin goldfish grouper hair hardhat heart helicopter highheel hockeypuck horse-deepfried hotdog house icepop-b igloo island jellyfish jupiter kangaroo ketchup laptop lightning-bolt lint lips lipstick2 lock macaroni mailbox maze microwave milk mirror mixer moon moose mosquito mountain-snowcap mouse mug mushroom mustard nigiri noodles onion orangutan orca otter outlet owl oyster paintbrush panda paperclip peanut pencil-tip peyote piano pickle pie piggybank pill pillow pineapple pipe pirateship pizza plane pop porkbao potato pufferfish pumpkin pyramid queencrown rabbit rainbow rangefinder raven retainer rgb ring road robot rock rosebud ruler-triangular saguaro sailboat sandwich saturn saw scorpion shark shower skateboard skeleton-hat skilift smile snowglobe snowmobile spaghetti sponge squid stapler star-sparkles steak sunset taco-classic taxi thumbsup toaster toiletpaper-full tooth toothbrush-fresh tornado trashcan turing ufo undead unicorn vent void volcano volleyball wall wallet wallsafe washingmachine watch watermelon wave weed weight werewolf whale-alive whale wine wizardhat zebra
Glasses random hip-rose black-eyes-red black-rgb black blue-med-saturated blue frog-green fullblack green-blue-multi grey-light guava honey magenta orange pink-purple-multi red smoke teal watermelon yellow-orange-multi yellow-saturated
Themes themes are preset traits. can be combined with individual traits but theme will take precendence. for example, a url with both theme=sharkdao and head=18 will return a noun with a shark head.
theme. options:sharkdao (head=187) gnars (head=189) nounsinblack (background=0, body=13, accessory=100, glasses=7) Try it!
Theme none sharkdao gnars nounsinblack
Size