Overflow Design

Searches Overflow Design's hand-drawn drawings by what they show: 1,120 icons, 457 illustrations and 71 isometric drawings. Use it when the user wants an icon, an illustration or an isometric drawing. Every word of the query must match a drawing's name or tags, and "icon", "illustration" or "isometric" in the query narrows the search to that set. Returns each match's id, name, set, category and page link, and marks the drawings this connection cannot fetch because they need an Overflow Pro licence.

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "description": "What the drawing should show, in plain words. Empty with a set or category to browse it.",
      "type": "string",
      "maxLength": 200
    },
    "set": {
      "description": "Only this set.",
      "type": "string",
      "enum": [
        "icons",
        "illustrations",
        "isometric"
      ]
    },
    "category": {
      "description": "Only this category, by its slug or its label.",
      "type": "string",
      "maxLength": 80
    },
    "tier": {
      "default": "all",
      "description": "free for drawings anybody can fetch, pro for the ones that need Pro.",
      "type": "string",
      "enum": [
        "all",
        "free",
        "pro"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 2000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns Overflow drawings by id, up to 20 at a time, as SVG or JSX. Icons and isometric stills come back inline as markup. Illustrations and animated isometric drawings, which run to tens of kilobytes, come back as a download link that works for fifteen minutes, with a curl command that saves the file; the delivery option returns them inline instead. Free drawings need no key; the others need an Overflow Pro licence key sent with the connection. Each result ends with the licence terms.

{
  "type": "object",
  "properties": {
    "ids": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "description": "Drawing ids, such as icon/calendar, illustration/office-club/teamwork or isometric/240/crate."
    },
    "style": {
      "default": "regular",
      "description": "Icons and illustrations: regular, or duotone with a second, lighter tone.",
      "type": "string",
      "enum": [
        "regular",
        "duotone"
      ]
    },
    "format": {
      "default": "svg",
      "description": "svg, or jsx: the same markup with React attribute names, to paste into a component.",
      "type": "string",
      "enum": [
        "svg",
        "jsx"
      ]
    },
    "animated": {
      "default": false,
      "description": "Isometric only: the moving version, a custom element with its own script, that moves under the pointer. Needs Pro.",
      "type": "boolean"
    },
    "fill": {
      "default": "colour",
      "description": "Isometric only: colour (the site's default), plain (greys) or stroke (outline only).",
      "type": "string",
      "enum": [
        "colour",
        "plain",
        "stroke"
      ]
    },
    "theme": {
      "default": "light",
      "description": "Isometric only: colours for a light page or a dark one.",
      "type": "string",
      "enum": [
        "light",
        "dark"
      ]
    },
    "delivery": {
      "default": "auto",
      "description": "auto: inline for icons and isometric stills, a link for the rest. Or inline, or link.",
      "type": "string",
      "enum": [
        "auto",
        "inline",
        "link"
      ]
    }
  },
  "required": [
    "ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Lists what Overflow Design has: the three sets with their counts, styles and categories, and what this connection's licence key unlocks.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}