Noun Project · Schema
Collection
A curated icon collection (icon set).
Art And DesignIconsSVGVisual LanguageDesign AssetsPublic APIs
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | Numeric identifier of the collection. |
| slug | string | URL-safe slug of the collection. |
| name | string | Display name of the collection. |
| description | string | Marketing description of the collection. |
| permalink | string | Canonical URL for the collection on thenounproject.com. |
| preview_url | string | Cover image URL for the collection. |
| creator | object | The creator of an icon. |
| date_created | string | ISO 8601 timestamp when the collection was created. |
| date_updated | string | ISO 8601 timestamp of the last collection update. |
| is_published | boolean | Whether the collection is published and discoverable. |
| icon_count | integer | Number of icons currently in the collection. |
| tags | array | Search tags applied to the collection. |
| icons | array | Member icons returned when retrieving a collection by ID. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/noun-project/refs/heads/main/json-schema/noun-project-collection-schema.json",
"title": "Collection",
"description": "A curated icon collection (icon set).",
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric identifier of the collection.",
"example": 98765
},
"slug": {
"type": "string",
"description": "URL-safe slug of the collection.",
"example": "weather-icons"
},
"name": {
"type": "string",
"description": "Display name of the collection.",
"example": "Weather Icons"
},
"description": {
"type": "string",
"description": "Marketing description of the collection.",
"example": "A complete weather iconography set covering conditions and forecasts."
},
"permalink": {
"type": "string",
"format": "uri",
"description": "Canonical URL for the collection on thenounproject.com.",
"example": "https://thenounproject.com/collection/98765/"
},
"preview_url": {
"type": "string",
"format": "uri",
"description": "Cover image URL for the collection.",
"example": "https://static.thenounproject.com/collections/98765-cover.png"
},
"creator": {
"type": "object",
"description": "The creator of an icon.",
"properties": {
"id": {
"type": "integer",
"description": "Numeric identifier of the creator.",
"example": 4321
},
"username": {
"type": "string",
"description": "URL-safe username of the creator.",
"example": "jsmith"
},
"name": {
"type": "string",
"description": "Display name of the creator.",
"example": "Jane Smith"
},
"permalink": {
"type": "string",
"format": "uri",
"description": "Canonical URL for the creator profile.",
"example": "https://thenounproject.com/jsmith/"
},
"location": {
"type": "string",
"description": "Free-text location reported by the creator.",
"example": "Brooklyn, NY"
},
"bio": {
"type": "string",
"description": "Creator's profile bio.",
"example": "Designer focused on space exploration icons."
},
"avatar_url": {
"type": "string",
"format": "uri",
"description": "URL to the creator's avatar image.",
"example": "https://static.thenounproject.com/avatars/4321.png"
}
},
"required": [
"id",
"username"
]
},
"date_created": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp when the collection was created.",
"example": "2024-04-12T10:00:00Z"
},
"date_updated": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of the last collection update.",
"example": "2024-09-30T18:22:00Z"
},
"is_published": {
"type": "boolean",
"description": "Whether the collection is published and discoverable.",
"example": true
},
"icon_count": {
"type": "integer",
"description": "Number of icons currently in the collection.",
"example": 32
},
"tags": {
"type": "array",
"description": "Search tags applied to the collection.",
"items": {
"type": "object",
"description": "A single search tag applied to an icon or collection.",
"properties": {
"id": {
"type": "integer",
"description": "Numeric identifier of the tag.",
"example": 999
},
"slug": {
"type": "string",
"description": "URL-safe slug of the tag.",
"example": "spaceship"
}
},
"required": [
"id",
"slug"
]
}
},
"icons": {
"type": "array",
"description": "Member icons returned when retrieving a collection by ID.",
"items": {
"type": "object",
"description": "A single icon in the Noun Project library.",
"properties": {
"id": {
"type": "integer",
"description": "Numeric identifier of the icon.",
"example": 1234567
},
"attribution": {
"type": "string",
"description": "Required attribution string when the icon is not public domain.",
"example": "rocket by Jane Smith from Noun Project"
},
"attribution_preview_url": {
"type": "string",
"format": "uri",
"description": "URL to a rendered attribution image suitable for design overlays.",
"example": "https://static.thenounproject.com/png/1234567-attribution.png"
},
"creator": {
"$ref": "#/components/schemas/IconCreator"
},
"date_uploaded": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp when the icon was uploaded.",
"example": "2024-08-15T13:45:00Z"
},
"is_active": {
"type": "boolean",
"description": "Whether the icon is currently active and available for download.",
"example": true
},
"is_public_domain": {
"type": "boolean",
"description": "Whether the icon has been released into the public domain.",
"example": false
},
"license_description": {
"type": "string",
"description": "Human-readable license summary.",
"example": "creative-commons-attribution"
},
"permalink": {
"type": "string",
"format": "uri",
"description": "Canonical URL for the icon on thenounproject.com.",
"example": "https://thenounproject.com/icon/1234567/"
},
"preview_url": {
"type": "string",
"format": "uri",
"description": "URL for the default-size preview image.",
"example": "https://static.thenounproject.com/png/1234567-200.png"
},
"preview_url_42": {
"type": "string",
"format": "uri",
"description": "URL for the 42-pixel thumbnail.",
"example": "https://static.thenounproject.com/png/1234567-42.png"
},
"preview_url_84": {
"type": "string",
"format": "uri",
"description": "URL for the 84-pixel thumbnail.",
"example": "https://static.thenounproject.com/png/1234567-84.png"
},
"preview_url_200": {
"type": "string",
"format": "uri",
"description": "URL for the 200-pixel thumbnail.",
"example": "https://static.thenounproject.com/png/1234567-200.png"
},
"icon_url": {
"type": "string",
"format": "uri",
"description": "Direct URL to the SVG asset (when include_svg is not used).",
"example": "https://static.thenounproject.com/svg/1234567.svg"
},
"svg": {
"type": "string",
"description": "Inline SVG markup when include_svg=true was requested.",
"example": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><path d=\"...\"/></svg>"
},
"style": {
"type": "string",
"description": "Visual style classification of the icon.",
"enum": [
"solid",
"line"
],
"example": "solid"
},
"line_weight": {
"type": "integer",
"description": "Line weight in pixels at 512px rendering (line-style icons only).",
"minimum": 1,
"maximum": 60,
"example": 4
},
"tags": {
"type": "array",
"description": "Search tags applied to the icon.",
"items": {
"$ref": "#/components/schemas/Tag"
}
},
"term": {
"type": "string",
"description": "Primary search term used to discover the icon.",
"example": "rocket"
},
"term_slug": {
"type": "string",
"description": "URL-safe version of the term.",
"example": "rocket"
},
"year_published": {
"type": "integer",
"description": "Year the icon was first published.",
"example": 2024
},
"royalty_free_license": {
"type": "boolean",
"description": "Whether the icon is included under the royalty-free license.",
"example": true
},
"nsfw": {
"type": "boolean",
"description": "Whether the icon has been flagged not-safe-for-work.",
"example": false
},
"sponsor_id": {
"type": [
"integer",
"null"
],
"description": "Identifier of the sponsoring brand if any.",
"example": null
},
"thumbnail_url": {
"type": "string",
"format": "uri",
"description": "Thumbnail URL at the requested thumbnail_size.",
"example": "https://static.thenounproject.com/png/1234567-200.png"
}
},
"required": [
"id",
"permalink"
]
}
}
},
"required": [
"id",
"name",
"permalink"
]
}