---
title: "Changes to Search Companies"
method: POST
path: "/v1/companies/search"
---

# Changes to Search Companies

`POST /v1/companies/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 96 revisions.

- **2026-10-14** `acc7d199f39a`: 5 info
- **2026-09-09** `8ede3e49dfc8`: 2 info
- **2026-08-12** `9fbd24075228`: 2 info
- **2026-07-31** `085f0682e12a`: 1 info
- **2026-07-26** `42f4f2e2c74a`: 3 info
- **2026-07-13** `641fc0ca14d0`: 1 breaking, 7 info
- **2026-05-10** `1dae359ce2c7`: 1 breaking, 21 info
- **2026-01-14** `ecd1eb029865`: 1 info

## Changes

- **2026-10-14** `acc7d199f39a`: 5 info
  - added the new optional request property `company_not_revealed_at_gte`
  - added the new optional request property `company_not_revealed_at_lte`
  - added the new optional request property `company_not_revealed_within_hours`
  - added the new optional request property `company_revealed_within_hours`
  - request property `revealed_company_data` reactivated
- **2026-09-09** `8ede3e49dfc8`: 2 info
  - added the new optional request property `company_revealed_at_gte`
  - added the new optional request property `company_revealed_at_lte`
- **2026-08-12** `9fbd24075228`: 2 info
  - added the new optional request property `job_filters/anyOf[subschema #1: JobFilters]/workplace_types_or`
  - request property `job_filters/anyOf[subschema #1: JobFilters]/remote` deprecated
- **2026-07-31** `085f0682e12a`: 1 info
  - the `order_by` request property default value `{"desc":true,"field":"relevance"}` was removed
- **2026-07-26** `42f4f2e2c74a`: 3 info
  - added the new optional request property `company_country_code_not_or_null`
  - added the new optional request property `industry_id_not_or_null`
  - added the new optional request property `min_num_jobs_found`
- **2026-07-13** `641fc0ca14d0`: 1 breaking, 7 info
  - removed `#/components/schemas/JobFilters` from the `job_filters` request property `anyOf` list
  - added the new optional request property `company_id_not`
  - added `#/components/schemas/JobFilters-Input` to the `job_filters` request property `anyOf` list
  - the `order_by` request property default value changed from `{"desc":true,"field":"confidence"}, {"desc":true,"field":"num_jobs_found"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"employee_count"}` to `{"desc":true,"field":"relevance"}`
  - added the new `relevance` enum value to the request property `order_by/items/field`
  - request property `company_technology_slug_and` reactivated
  - request property `company_technology_slug_not` reactivated
  - request property `company_technology_slug_or` reactivated
- **2026-05-10** `1dae359ce2c7`: 1 breaking, 21 info
  - removed `#/components/schemas/TechnographicsTechnologyFilters` from the `tech_filters` request property `anyOf` list
  - added the new optional request property `company_keyword_slug_and`
  - added the new optional request property `company_keyword_slug_not`
  - added the new optional request property `company_keyword_slug_or`
  - added the new optional request property `cursor`
  - added the new optional request property `job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_and`
  - added the new optional request property `job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_and`
  - added the new optional request property `job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_not`
  - added the new optional request property `job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_or`
  - added `#/components/schemas/KeywordFilters` to the `tech_filters` request property `anyOf` list
  - request property `company_technology_slug_and` deprecated
  - request property `company_technology_slug_not` deprecated
  - request property `company_technology_slug_or` deprecated
  - request property `job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_case_sensitive_or` deprecated
  - added the optional property `data/items/company_tags` to the response with the `200` status
  - added the optional property `data/items/jobs_found/items/source_url` to the response with the `200` status
  - added the optional property `data/items/keyword_slugs` to the response with the `200` status
  - added the optional property `data/items/keywords_found` to the response with the `200` status
  - added the optional property `data/items/num_buying_intent_topics` to the response with the `200` status
  - added the optional property `data/items/num_keywords` to the response with the `200` status
  - added the optional property `data/items/technologies_found/items/technology/type` to the response with the `200` status
  - response property `data/items/company_keywords` deprecated
- **2026-01-14** `ecd1eb029865`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/theirstack/apis/theirstack-api-reference/docs/v1/companies/search/post.md) - [API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [Page](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v1/companies/search/post)