{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/companyenrich/json-schema/companyenrich-company-enrich-v2-request-schema.json",
  "title": "CompanyEnrichV2Request",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/companyenrich-openapi.json#/components/schemas/CompanyEnrichV2Request",
  "type": "object",
  "properties": {
    "name": {
      "maxLength": 250,
      "type": [
        "string",
        "null"
      ],
      "description": "The company name"
    },
    "linkedinUrl": {
      "maxLength": 2048,
      "type": [
        "string",
        "null"
      ],
      "description": "The company LinkedIn URL",
      "format": "uri"
    },
    "linkedinId": {
      "maxLength": 100,
      "type": [
        "string",
        "null"
      ],
      "description": "The company LinkedIn ID"
    },
    "twitterUrl": {
      "maxLength": 2048,
      "type": [
        "string",
        "null"
      ],
      "description": "The company Twitter/X URL",
      "format": "uri"
    },
    "facebookUrl": {
      "maxLength": 2048,
      "type": [
        "string",
        "null"
      ],
      "description": "The company Facebook URL",
      "format": "uri"
    },
    "instagramUrl": {
      "maxLength": 2048,
      "type": [
        "string",
        "null"
      ],
      "description": "The company Instagram URL",
      "format": "uri"
    },
    "youtubeUrl": {
      "maxLength": 2048,
      "type": [
        "string",
        "null"
      ],
      "description": "The company YouTube URL",
      "format": "uri"
    },
    "expand": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "enum": [
          "financial",
          "keywords",
          "naicsCodes",
          "technologies",
          "workforce"
        ],
        "type": "string"
      },
      "description": "Additional company data to include. Each requested expansion is charged per returned company, on top of the base cost:\n\n- `financial`: 1 credit\n- `keywords`: 1 credit\n- `naicsCodes`: 1 credit\n- `technologies`: 1 credit\n- `workforce`: 1 credit. Includes the latest 12 months of history; each earlier 12-month page from `GET /v2/companies/workforce` costs another 1 credit."
    }
  }
}