{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/echoloc-ai/json-schema/echoloc-ai-tech-search-response-schema.json",
  "title": "TechSearchResponse",
  "description": "Paginated companies using the requested technologies, ranked by usage.",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/echoloc-ai-api-openapi.json#/components/schemas/TechSearchResponse",
  "properties": {
    "technologies": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Technologies"
    },
    "match": {
      "type": "string",
      "title": "Match"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Industry"
    },
    "employees_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Employees Min"
    },
    "employees_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Employees Max"
    },
    "total": {
      "type": "integer",
      "title": "Total"
    },
    "page": {
      "type": "integer",
      "title": "Page"
    },
    "page_size": {
      "type": "integer",
      "title": "Page Size"
    },
    "total_pages": {
      "type": "integer",
      "title": "Total Pages"
    },
    "results": {
      "items": {
        "$ref": "#/$defs/TechCompanyResult"
      },
      "type": "array",
      "title": "Results",
      "default": []
    }
  },
  "type": "object",
  "required": [
    "technologies",
    "match",
    "total",
    "page",
    "page_size",
    "total_pages"
  ],
  "$defs": {
    "HiringStats": {
      "properties": {
        "total_active_jobs": {
          "type": "integer",
          "title": "Total Active Jobs",
          "default": 0
        },
        "jobs_last_7d": {
          "type": "integer",
          "title": "Jobs Last 7D",
          "default": 0
        },
        "jobs_last_30d": {
          "type": "integer",
          "title": "Jobs Last 30D",
          "default": 0
        },
        "jobs_last_90d": {
          "type": "integer",
          "title": "Jobs Last 90D",
          "default": 0
        },
        "hiring_velocity": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hiring Velocity"
        },
        "hiring_ratio": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hiring Ratio"
        },
        "leadership_positions_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Leadership Positions Count"
        },
        "departments": {
          "type": "object",
          "title": "Departments",
          "default": {}
        },
        "seniority": {
          "type": "object",
          "title": "Seniority",
          "default": {}
        },
        "notable_roles": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Notable Roles",
          "default": []
        }
      },
      "type": "object",
      "title": "HiringStats",
      "description": "Hiring activity for a company, aggregated from active job postings."
    },
    "TechCompanyResult": {
      "properties": {
        "company_id": {
          "type": "string",
          "title": "Company Id"
        },
        "name": {
          "type": "string",
          "title": "Name"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Domain"
        },
        "short_description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Short Description"
        },
        "industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Industry"
        },
        "company_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Company Type"
        },
        "founded_year": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Founded Year"
        },
        "country": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Country"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "City"
        },
        "employees_range_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Employees Range Min"
        },
        "employees_range_max": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Employees Range Max"
        },
        "linkedin_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Linkedin Url"
        },
        "hiring": {
          "allOf": [
            {
              "$ref": "#/$defs/HiringStats"
            }
          ],
          "default": {
            "total_active_jobs": 0,
            "jobs_last_7d": 0,
            "jobs_last_30d": 0,
            "jobs_last_90d": 0,
            "departments": {},
            "seniority": {},
            "notable_roles": []
          }
        },
        "technologies": {
          "items": {
            "$ref": "#/$defs/TechUsage"
          },
          "type": "array",
          "title": "Technologies",
          "default": []
        },
        "tech_using": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Tech Using",
          "default": []
        },
        "tech_adopting": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Tech Adopting",
          "default": []
        },
        "tech_replacing": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Tech Replacing",
          "default": []
        },
        "tech_evaluating": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Tech Evaluating",
          "default": []
        },
        "usage_count": {
          "type": "integer",
          "title": "Usage Count",
          "default": 0
        },
        "matched_technologies": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Matched Technologies",
          "default": []
        }
      },
      "type": "object",
      "required": [
        "company_id",
        "name"
      ],
      "title": "TechCompanyResult",
      "description": "A company in tech-search results, with how the queried techs matched."
    },
    "TechUsage": {
      "properties": {
        "name": {
          "type": "string",
          "title": "Name"
        },
        "count": {
          "type": "integer",
          "title": "Count"
        }
      },
      "type": "object",
      "required": [
        "name",
        "count"
      ],
      "title": "TechUsage",
      "description": "A technology in a company's stack with how many signals reference it."
    }
  }
}