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

  • name

Try it!

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

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!

Size

  • size

Try it!