The Noun Project is a visual language platform providing access to nearly 10 million royalty-free PNG and SVG icons through an OAuth 1.0a-secured REST API. The v2 API supports icon search with style and line-weight filtering, similar-icon lookup, collection browsing, custom recoloring, autocomplete, per-client blocklists, and usage telemetry. Built on AWS, it serves more than 300 million requests per month at 99.99% uptime.
Noun Project is listed with 5 APIs on the APIs.io network, including Autocomplete API, Blocklist API, Collection API, and 2 more. Tagged areas include Icons, SVG, Visual Language, Design Assets, and Public APIs.
The Noun Project catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Noun Project’s developer surface includes authentication, pricing, signup flow, support, engineering blog, and 13 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/noun-project/"><img src="https://apis.io/badge/noun-project/card.svg" alt="Noun Project on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
8 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
Not yet checked against Noun Project's own pricing page. Compiled by API Evangelist on 2026-05-28 from thenounproject.com/api/; confirm before you rely on a figure. A free plan or tier is listed.
aid: noun-project
name: Noun Project
description: The Noun Project is a visual language platform providing access to nearly 10 million royalty-free PNG and SVG
icons through an OAuth 1.0a-secured REST API. The v2 API supports icon search with style and line-weight filtering, similar-icon
lookup, collection browsing, custom recoloring, autocomplete, per-client blocklists, and usage telemetry. Built on AWS,
it serves more than 300 million requests per month at 99.99% uptime.
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: open
trial: true
try_now: true
public: true
gated: none
gated_source:
- onboarding
label: Freemium (free trial) · Open access
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: https://thenounproject.com/icon.png
url: http://api.thenounproject.com/index.html
humanURL: https://thenounproject.com/api/
baseURL: https://api.thenounproject.com
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-05-28'
x-source: public-apis/public-apis
x-type: company
x-category: Art & Design
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Icons
- SVG
- Visual Language
- Design Assets
- Public APIs
- Design
apis:
- aid: noun-project:noun-project-autocomplete-api
name: Noun Project Autocomplete API
description: Suggest search terms based on a query prefix.
humanURL: https://api.thenounproject.com/documentation.html
baseURL: https://api.thenounproject.com
tags:
- Autocomplete
properties:
- type: OpenAPI
url: openapi/noun-project-autocomplete-api-openapi.yml
- type: Documentation
url: https://api.thenounproject.com/documentation.html
- type: GettingStarted
url: https://api.thenounproject.com/getting_started.html
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: APIExplorer
url: https://api.thenounproject.com/explorer
- type: Authentication
url: https://api.thenounproject.com/getting_started.html
- aid: noun-project:noun-project-blocklist-api
name: Noun Project Blocklist API
description: Manage per-client blocklists for icon IDs, collection IDs, and terms.
humanURL: https://api.thenounproject.com/documentation.html
baseURL: https://api.thenounproject.com
tags:
- Blacklist
tags_raw:
- Blocklist
properties:
- type: OpenAPI
url: openapi/noun-project-blocklist-api-openapi.yml
- type: Documentation
url: https://api.thenounproject.com/documentation.html
- type: GettingStarted
url: https://api.thenounproject.com/getting_started.html
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: APIExplorer
url: https://api.thenounproject.com/explorer
- type: Authentication
url: https://api.thenounproject.com/getting_started.html
- aid: noun-project:noun-project-collection-api
name: Noun Project Collection API
description: Search and retrieve curated icon collections (icon sets).
humanURL: https://api.thenounproject.com/documentation.html
baseURL: https://api.thenounproject.com
tags:
- Collection
properties:
- type: OpenAPI
url: openapi/noun-project-collection-api-openapi.yml
- type: Documentation
url: https://api.thenounproject.com/documentation.html
- type: GettingStarted
url: https://api.thenounproject.com/getting_started.html
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: APIExplorer
url: https://api.thenounproject.com/explorer
- type: Authentication
url: https://api.thenounproject.com/getting_started.html
- aid: noun-project:noun-project-icon-api
name: Noun Project Icon API
description: Search, filter, retrieve, and download icons from the Noun Project library.
humanURL: https://api.thenounproject.com/documentation.html
baseURL: https://api.thenounproject.com
tags:
- Icon
properties:
- type: OpenAPI
url: openapi/noun-project-icon-api-openapi.yml
- type: Documentation
url: https://api.thenounproject.com/documentation.html
- type: GettingStarted
url: https://api.thenounproject.com/getting_started.html
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: APIExplorer
url: https://api.thenounproject.com/explorer
- type: Authentication
url: https://api.thenounproject.com/getting_started.html
- aid: noun-project:noun-project-usage-api
name: Noun Project Usage API
description: Inspect current API key usage against documented quotas.
humanURL: https://api.thenounproject.com/documentation.html
baseURL: https://api.thenounproject.com
tags:
- Usage
properties:
- type: OpenAPI
url: openapi/noun-project-usage-api-openapi.yml
- type: Documentation
url: https://api.thenounproject.com/documentation.html
- type: GettingStarted
url: https://api.thenounproject.com/getting_started.html
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: APIExplorer
url: https://api.thenounproject.com/explorer
- type: Authentication
url: https://api.thenounproject.com/getting_started.html
common:
- type: PostmanWorkspace
url: https://www.postman.com/kinlaneapi/noun-project/overview
- type: AgenticAccess
url: agentic-access/noun-project-agentic-access.yml
- type: DomainSecurity
url: security/noun-project-domain-security.yml
- type: Authentication
url: authentication/noun-project-authentication.yml
- type: Website
url: https://thenounproject.com/
- type: Pricing
url: https://thenounproject.com/api/
- type: Signup
url: https://thenounproject.com/developers/apps/
- type: Support
url: https://thenounproject.zendesk.com/
- type: HelpCenter
url: https://help.thenounproject.com/
- type: GitHubOrganization
url: https://github.com/TheNounProject
- type: TermsOfService
url: https://thenounproject.com/legal/api-terms-of-use/
- type: PublicAPIsListing
url: https://github.com/public-apis/public-apis
- type: Plans
url: plans/noun-project-plans-pricing.yml
- type: RateLimits
url: rate-limits/noun-project-rate-limits.yml
- type: FinOps
url: finops/noun-project-finops.yml
- type: Vocabulary
url: vocabulary/noun-project-vocabulary.yml
- type: SpectralRules
url: rules/noun-project-rules.yml
- url: https://blog.thenounproject.com/feed/
type: Blog
features:
- name: Icon Search
description: Search nearly 10 million icons by query term, with optional filters for style (solid/line), line weight (1-60
pixels at 512px rendering), public domain status, and thumbnail size.
- name: Similar Icons
description: Discover stylistically similar icons by providing a seed icon ID, enabling consistent visual language across
a project.
- name: Icon Download with Recoloring
description: Download any icon in SVG or PNG format with a custom hexadecimal color and pixel size (20-1200 for PNG).
- name: Collection Browsing
description: Search and retrieve curated icon collections (icon sets) with full metadata and member icons.
- name: Autocomplete
description: Suggest search terms based on a query prefix, returning up to 10 matches.
- name: Per-Client Blocklist
description: Maintain a per-API-key blocklist of icon IDs, collection IDs, terms, and phrases to filter out unwanted content
from search results. Blocklist is cached for 10 minutes.
- name: Usage Telemetry
description: Retrieve current API key usage against hourly, daily, and monthly limits via the /v2/client/usage endpoint.
useCases:
- name: Icon Library Integration
description: Embed Noun Project's visual language into a design tool, no-code builder, or web/mobile application so end
users can pick from millions of icons without leaving the host product.
- name: Branded Iconography
description: Recolor icons to match brand palettes on the fly using the hex color parameter on the download endpoint, eliminating
per-icon design work.
- name: Style-Consistent Design Systems
description: Use the more-like-this endpoint to source visually consistent icon sets from a single seed icon, accelerating
design system curation.
- name: Content Moderation
description: Apply per-client blocklists to suppress icons that conflict with brand safety, regional, or audience-appropriate
guidelines.
- name: Educational and Reference Tools
description: Pair the autocomplete and icon search endpoints to power glossary-style visual references and learning tools.
integrations:
- name: OAuth 1.0a Client Libraries
description: Compatible with any standards-compliant OAuth 1.0a library, including requests_oauthlib (Python), oauth1 (Node.js),
Faraday-OAuth (Ruby), DotNetOpenAuth (.NET), and Guzzle OAuth Subscriber (PHP).
- name: Sketch
description: The provider maintains Sketch plugin tooling (SketchPluginReloader) and historically distributed a Noun Project
Sketch plugin.
- name: Microsoft Office and Google Workspace
description: Provider-distributed plugins for Microsoft 365 and Google Slides surface the same icon catalog backed by this
API.
solutions:
- name: Design Tool Vendors
description: Power icon pickers, asset browsers, and template galleries inside design, presentation, and document-creation
tools.
- name: Marketing and Brand Teams
description: On-demand recoloring of icons to enforce brand palettes across web, print, and presentation assets.
- name: Education Platforms
description: Add visual reference material to learning content with royalty-free, commercially-licensed icons.
- name: No-Code and Low-Code Builders
description: Expose a curated icon library to citizen developers building dashboards, portals, and forms.
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
x-tags-removed:
- Art And Design
Noun Project API — frequently asked questions
Does Noun Project have an API?
Yes. APIs.io lists 5 APIs from Noun Project, including Noun Project Autocomplete API, Noun Project Blocklist API and Noun Project Collection API, and 2 more.
Is there an OpenAPI specification for the Noun Project API?
Yes. APIs.io indexes 5 OpenAPI specifications for Noun Project, each linked for download from this page.
How do I authenticate with the Noun Project API?
Noun Project uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Noun Project Authentication.
How much does the Noun Project API cost?
APIs.io lists 3 pricing plans for Noun Project, with each plan's price, limits and inclusions under Pricing on this page.
Is the Noun Project API ready for AI agents?
Noun Project has a Kin Score of 31.3 out of 100 (thin) and an Agent Readiness score of 24.6 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.