---
title: "Search Companies By Technologies"
method: POST
path: "/api/corporate/v1/companies/by-technologies"
tags: ["corporate"]
---

# Search Companies By Technologies

`POST /api/corporate/v1/companies/by-technologies`

## Request

- Base URL: `https://api.echoloc.ai`
- URL: `https://api.echoloc.ai/api/corporate/v1/companies/by-technologies`
- Auth: none declared

Find companies using the given technologies, ranked by total usage count.

`match=any` (default) → companies using at least one; `match=all` → every one.
Case-insensitive (e.g. "PYTHON" == "Python"). Paginated.

## Headers

- `x-api-key` string, nullable

## Request body

- TechSearchRequest: Find companies using a set of technologies, ranked by usage.
  - `technologies` string[], required: Technology names; case-insensitive
  - `match` 'any' | 'all'
  - `country` string, nullable: Exact country name, e.g. 'United Kingdom' (see /countries)
  - `industry` string, nullable: Exact industry name, e.g. 'Financial Services' (see /industries)
  - `employees_min` integer, nullable: Company size band overlaps [employees_min, employees_max]
  - `employees_max` integer, nullable
  - `exclude_agencies` boolean: Exclude staffing, outsourcing, consulting and agency industries (default true). Ignored when `industry` is set.
  - `page` integer
  - `page_size` integer

## Response `200`

Successful Response

- TechSearchResponse: Paginated companies using the requested technologies, ranked by usage.
  - `technologies` string[], required
  - `match` string, required
  - `country` string, nullable
  - `industry` string, nullable
  - `employees_min` integer, nullable
  - `employees_max` integer, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `results` TechCompanyResult[]
    - `company_id` string, required
    - `name` string, required
    - `domain` string, nullable
    - `short_description` string, nullable
    - `industry` string, nullable
    - `company_type` string, nullable
    - `founded_year` string, nullable
    - `country` string, nullable
    - `city` string, nullable
    - `employees_range_min` integer, nullable
    - `employees_range_max` integer, nullable
    - `linkedin_url` string, nullable
    - `hiring` HiringStats: Hiring activity for a company, aggregated from active job postings.
      - `total_active_jobs` integer
      - `jobs_last_7d` integer
      - `jobs_last_30d` integer
      - `jobs_last_90d` integer
      - `hiring_velocity` string, nullable
      - `hiring_ratio` number, nullable
      - `leadership_positions_count` integer, nullable
      - `departments` object
      - `seniority` object
      - `notable_roles` string[]
    - `technologies` TechUsage[]
      - `name` string, required
      - `count` integer, required
    - `tech_using` string[]
    - `tech_adopting` string[]
    - `tech_replacing` string[]
    - `tech_evaluating` string[]
    - `usage_count` integer
    - `matched_technologies` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/echoloc/apis/echoloc-api.md) · [All operations](https://skmtc.dev/echoloc/apis/echoloc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/echoloc/apis/echoloc-api/revisions/ff18cb6db3fc?raw)
