Industry Category & Filter Value Lookup

{
  "type": "object",
  "required": [
    "search"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number for pagination."
    },
    "size": {
      "type": "integer",
      "description": "Requested results per page. The API may return a different perPage value."
    },
    "search": {
      "type": "string",
      "description": "Search keyword to filter industries."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "status",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "meta",
        "suggestions"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "currentPage",
            "firstPage",
            "lastPage",
            "perPage",
            "total"
          ],
          "properties": {
            "total": {
              "type": "integer",
              "description": "Total number of industries matching the search keyword, across all pages."
            },
            "perPage": {
              "type": "integer",
              "description": "Results per page actually returned."
            },
            "lastPage": {
              "type": "integer",
              "description": "The last available page number for this search (e.g. 24 for a 232-match search at 10 per page; 1 when there are no matches)."
            },
            "firstPage": {
              "type": "integer",
              "description": "Always 1 on both real calls observed."
            },
            "currentPage": {
              "type": "integer",
              "description": "The page number returned."
            }
          },
          "description": "Pagination and result-count metadata for this search.",
          "additionalProperties": true
        },
        "suggestions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value",
              "companiesCount"
            ],
            "properties": {
              "label": {
                "type": "string",
                "description": "Human-readable industry name, e.g. 'computer software'."
              },
              "value": {
                "type": "string",
                "description": "The slug-style filter value to pass into a company search or enrichment lookup, e.g. 'computer-software'."
              },
              "companiesCount": {
                "type": "integer",
                "description": "Number of companies the vendor classifies under this industry."
              }
            },
            "additionalProperties": true
          },
          "description": "Matching industries for this page of results. Empty when the keyword matches nothing (see examples/zzzznonexistent-empty.json), never absent."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed."
    }
  },
  "description": "The industry search result, as returned at the endpoint's result path.",
  "additionalProperties": true
}