Noun Project website screenshot

Noun Project

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 publishes 5 APIs on the APIs.io network, including Autocomplete API, Blocklist API, Collection API, and 2 more. Tagged areas include Art And Design, Icons, SVG, Visual Language, and Design Assets.

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 12 more developer resources.

51.4/100 developing ▼ -7.3 Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumOpenFree trial⚡ Free to try
5 APIs
Art And DesignIconsSVGVisual LanguageDesign AssetsPublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 51.4/100 · developing
Contract Quality 14.6 / 25
Developer Ergonomics 3.5 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 8.2 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/noun-project: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Noun Project Autocomplete API

Suggest search terms based on a query prefix.

Noun Project Blocklist API

Manage per-client blocklists for icon IDs, collection IDs, and terms.

Noun Project Collection API

Search and retrieve curated icon collections (icon sets).

Noun Project Icon API

Search, filter, retrieve, and download icons from the Noun Project library.

Noun Project Usage API

Inspect current API key usage against documented quotas.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Noun Project API V2

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Noun Project Rate Limits

12 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Noun Project Context

16 classes · 61 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Noun Project API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Noun Project API Rules

49 rules · 18 errors 24 warnings 7 info

SPECTRAL

JSON Schema 16

Standalone JSON Schema definitions for this provider's data models.

AutocompleteResponse

2 properties

JSON SCHEMA

BlocklistIdRequest

2 properties

JSON SCHEMA

BlocklistResponse

2 properties

JSON SCHEMA

Blocklist

4 properties

JSON SCHEMA

BlocklistTermRequest

2 properties

JSON SCHEMA

CollectionResponse

2 properties

JSON SCHEMA

Collection

13 properties

JSON SCHEMA

CollectionSearchResponse

5 properties

JSON SCHEMA

IconCreator

7 properties

JSON SCHEMA

IconResponse

2 properties

JSON SCHEMA

Icon

25 properties

JSON SCHEMA

IconSearchResponse

5 properties

JSON SCHEMA

Tag

2 properties

JSON SCHEMA

UsageResponse

2 properties

JSON SCHEMA

Usage

3 properties

JSON SCHEMA

UsageWindow

6 properties

JSON SCHEMA

Scroll for all 16

JSON Structure 16

JSON Structure definitions describing this provider's data shapes.

Noun Project Blocklist Response Structure

2 properties

JSON STRUCTURE

Noun Project Blocklist Structure

4 properties

JSON STRUCTURE

Noun Project Collection Response Structure

2 properties

JSON STRUCTURE

Noun Project Collection Structure

13 properties

JSON STRUCTURE

Noun Project Icon Creator Structure

7 properties

JSON STRUCTURE

Noun Project Icon Response Structure

2 properties

JSON STRUCTURE

Noun Project Icon Structure

25 properties

JSON STRUCTURE

Noun Project Tag Structure

2 properties

JSON STRUCTURE

Noun Project Usage Response Structure

2 properties

JSON STRUCTURE

Noun Project Usage Structure

3 properties

JSON STRUCTURE

Noun Project Usage Window Structure

6 properties

JSON STRUCTURE

Scroll for all 16

Examples 16

Example request and response payloads for these APIs.

Noun Project Icon Example

25 fields

EXAMPLE

Noun Project Tag Example

2 fields

EXAMPLE

Scroll for all 16

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Noun Project Authentication

apiKey · 1 scheme

SECURITY

Noun Project Domain Security

TLSv1.3 · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Noun Project Agentic Access

11 operations · 2 acting

11 operations · 2 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 4

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
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.
accessModel:
  pricing: freemium
  onboarding: open
  trial: true
  try_now: true
  public: true
  label: Freemium (free trial) · Open access
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  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.20'
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:
- Art And Design
- Icons
- SVG
- Visual Language
- Design Assets
- Public APIs
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:
  - 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: 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