Noun Project · Schema
IconSearchResponse
Paginated icon search results.
Art And DesignIconsSVGVisual LanguageDesign AssetsPublic APIs
Properties
| Name | Type | Description |
|---|---|---|
| icons | array | Icons matching the search criteria. |
| generated_at | string | ISO 8601 timestamp of when the response was generated. |
| total | integer | Total number of icons matching the search. |
| next_page | stringnull | Cursor token for the next page of results. |
| prev_page | stringnull | Cursor token for the previous page of results. |
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-icon-search-response-schema.json",
"title": "IconSearchResponse",
"description": "Paginated icon search results.",
"type": "object",
"properties": {
"icons": {
"type": "array",
"description": "Icons matching the search criteria.",
"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"
]
}
},
"generated_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of when the response was generated.",
"example": "2026-05-28T14:00:00Z"
},
"total": {
"type": "integer",
"description": "Total number of icons matching the search.",
"example": 4321
},
"next_page": {
"type": [
"string",
"null"
],
"description": "Cursor token for the next page of results.",
"example": "eyJsYXN0X2lkIjoxMjM0NTY3fQ=="
},
"prev_page": {
"type": [
"string",
"null"
],
"description": "Cursor token for the previous page of results.",
"example": null
}
},
"required": [
"icons"
]
}