Noun Project Icon Search Response Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/noun-project/refs/heads/main/json-structure/noun-project-icon-search-response-structure.json",
  "name": "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": "int32",
            "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": "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": "datetime",
            "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": "uri",
            "description": "Canonical URL for the icon on thenounproject.com.",
            "example": "https://thenounproject.com/icon/1234567/"
          },
          "preview_url": {
            "type": "uri",
            "description": "URL for the default-size preview image.",
            "example": "https://static.thenounproject.com/png/1234567-200.png"
          },
          "preview_url_42": {
            "type": "uri",
            "description": "URL for the 42-pixel thumbnail.",
            "example": "https://static.thenounproject.com/png/1234567-42.png"
          },
          "preview_url_84": {
            "type": "uri",
            "description": "URL for the 84-pixel thumbnail.",
            "example": "https://static.thenounproject.com/png/1234567-84.png"
          },
          "preview_url_200": {
            "type": "uri",
            "description": "URL for the 200-pixel thumbnail.",
            "example": "https://static.thenounproject.com/png/1234567-200.png"
          },
          "icon_url": {
            "type": "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": "int32",
            "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": "int32",
            "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": "uri",
            "description": "Thumbnail URL at the requested thumbnail_size.",
            "example": "https://static.thenounproject.com/png/1234567-200.png"
          }
        },
        "required": [
          "id",
          "permalink"
        ]
      }
    },
    "generated_at": {
      "type": "datetime",
      "description": "ISO 8601 timestamp of when the response was generated.",
      "example": "2026-05-28T14:00:00Z"
    },
    "total": {
      "type": "int32",
      "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"
  ]
}