> ## Documentation Index
> Fetch the complete documentation index at: https://www.hirebase.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Filter Companies and Jobs by Technology

> New technology filters on Search Companies and Search Jobs, and the technologies on each job.

> [!WARNING]
>
> **Beta, coming soon.** These parameters are in development and not accepted yet: today Search Companies and Search Jobs return `422` for them. Fields may change before launch. See [Technologies (Beta)](https://www.hirebase.org/docs/guides/technologies.md). Email [spencer@hirebase.org](mailto:spencer@hirebase.org) for early access.

## Search Companies

Four new body fields on [Search Companies](https://www.hirebase.org/docs/api-reference/companies/search-companies.md) (`POST /v2/hirebase/companies/search`). They combine with every existing filter, so size, location, industry and funding work as before. A company matches a technology only if it uses it: tier `medium` or `high`, seen in the last 18 months.

**technology\_slugs** `string[]`

Companies that use **any** of these technologies. Prefix a slug with `-` to exclude companies that use it: `["snowflake", "bigquery", "-amazon-redshift"]` means Snowflake or BigQuery, and not Redshift. Unknown slugs return `422`. Find slugs with [Search Technologies](https://www.hirebase.org/docs/api-reference/technologies/search-technologies.md).

**technology\_categories** `string[]`

Companies that use any technology in these categories, e.g. `["ent.crm"]`. A group slug (`sec`) covers every category in it. Prefix with `-` to exclude. See [List Technology Categories](https://www.hirebase.org/docs/api-reference/technologies/list-categories.md).

**technology\_min\_match** `integer` (default: 1)

How many of the included `technology_slugs` a company must use. Set it to the number of slugs for "uses all of them", or between 1 and that number for "uses at least N of them".

**include** `string[]`

Pass `["technologies"]` to add a `technologies` array to each company: the [evidence record](https://www.hirebase.org/docs/guides/technologies.md#the-evidence-record) for every requested technology the company uses, or its top 10 technologies when you filter on none.

```json Request theme={null}
POST /v2/hirebase/companies/search
{
  "hq_geolocations": [{ "country": "United States" }],
  "industries": ["Finance"],
  "company_sizes": ["201-500", "501-1000", "1001-5000"],
  "technology_slugs": ["snowflake", "bigquery", "-amazon-redshift"],
  "include": ["technologies"],
  "limit": 25
}
```

## Search Jobs

**technology\_slugs** `string[]`

Jobs whose description mentions **any** of these technologies; prefix with `-` to exclude. Works on [Search Jobs](https://www.hirebase.org/docs/api-reference/jobs/search-post.md), [Estimate](https://www.hirebase.org/docs/api-reference/jobs/estimate.md) and [Export Jobs](https://www.hirebase.org/docs/api-reference/jobs/export-jobs.md).

```json Request theme={null}
POST /v2/jobs/search
{
  "job_titles": ["Data Engineer"],
  "technology_slugs": ["apache-kafka"],
  "limit": 25
}
```

### New field on every job: `detected_technologies`

Search, export and [Get Job by ID](https://www.hirebase.org/docs/api-reference/jobs/get-by-id.md) return a new `detected_technologies` array, one entry per technology in order of first mention. The existing `technologies` field (a list of names) is unchanged.

**detected\_technologies** `object[] | null`

`null` means the job hasn't been analyzed yet; an empty array means it was analyzed and names no technology.

**slug** `string`

Technology slug.

**name** `string`

Display name.

**category** `object`

Primary category: `slug` and `name`.

**required** `boolean`

`true` when it appears in the job's requirements.

**in\_title** `boolean`

`true` when it appears in the job title.

```json theme={null}
"detected_technologies": [
  {
    "slug": "apache-kafka",
    "name": "Apache Kafka",
    "category": { "slug": "backend.messaging", "name": "Backend Development > Messaging and event streaming" },
    "required": true,
    "in_title": false
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.