# December 2025

## Clean Company Data

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="ehWPJUPr4Tcc" label="October, 2025" color="blue"></option><option value="DIoZa9t0XBxA" label="October 1, 2025" color="blue"></option><option value="Kj17mBXPc4hB" label="October 8, 2025" color="blue"></option><option value="0N0O3OHqkWPl" label="November, 2025" color="blue"></option><option value="ECkJbWZzl5d6" label="December 1, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="ECkJbWZzl5d6">December 1, 2025</span></td><td>Adding new fields</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added fields</mark>&#x20;

| Data field                                | Processing | Description                               | Data type |
| ----------------------------------------- | ---------- | ----------------------------------------- | --------- |
| `company_locations_full.city`             | Enriched   | Location city                             | String    |
| `company_locations_full.state`            | Enriched   | Location state                            | String    |
| `company_locations_full.country_code`     | Enriched   | Country code                              | String    |
| `company_locations_full.country`          | Enriched   | Country                                   | String    |
| `company_locations_full.country_iso_2`    | Enriched   | ISO 2-letter code of the location country | String    |
| `company_locations_full.country_iso_3`    | Enriched   | ISO 3-letter code of the location country | String    |
| `company_locations_full.regions`          | Enriched   | Regions list                              | Struct    |
| `company_locations_full.regions[].region` | Enriched   | Region                                    | String    |

## Indeed Jobs Data

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="ehWPJUPr4Tcc" label="October, 2025" color="blue"></option><option value="DIoZa9t0XBxA" label="October 1, 2025" color="blue"></option><option value="Kj17mBXPc4hB" label="October 8, 2025" color="blue"></option><option value="0N0O3OHqkWPl" label="November, 2025" color="blue"></option><option value="ECkJbWZzl5d6" label="December 1, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="ECkJbWZzl5d6">December 1, 2025</span></td><td>Adding new fields and updating one field</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added fields</mark>&#x20;

| Data field             | Description                                                                   | Data type |
| ---------------------- | ----------------------------------------------------------------------------- | --------- |
| `attributes`           | List of job attributes                                                        | Array     |
| `company_tier`         | Indicates the company’s tier or size level                                    | String    |
| `hire_count`           | Number of open positions for the job                                          | Integer   |
| `is_fair_chance`       | Indicates if the job supports fair chance (e.g., for applicants with records) | Boolean   |
| `job_age`              | Displays the age of the job posting (e.g., "`3 days ago`")                    | String    |
| `organic_applications` | Number of organic applications received (non-sponsored)                       | Integer   |

### &#x20;<mark style="color:$info;">Changed field</mark>

| Data field | Old data type | New data type |
| ---------- | ------------- | ------------- |
| `job_type` | String        | Array         |

## Multi-source Company API

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="BrFNqrq8qUru" label="September 23, 2025" color="blue"></option><option value="R4kzybFgtnjf" label="September 24, 2025" color="blue"></option><option value="rE1uTmK1Qykr" label="November 28, 2025" color="blue"></option><option value="rdghCLE1DuW1" label="December 2, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="rdghCLE1DuW1">December 2, 2025</span></td><td><strong>Breaking change</strong> – Multi-source Company API Elasticsearch DSL schema has been updated. Several field types have been changed from a <code>flattened</code> to a <code>nested</code> format.</td></tr></tbody></table>

### &#x20;<mark style="color:$danger;">Affected fields</mark>

| Field Name                            | Old type  | New type |
| ------------------------------------- | --------- | -------- |
| `base_salary`                         | flattened | nested   |
| `additional_pay`                      | flattened | nested   |
| `total_salary`                        | flattened | nested   |
| `employees_count_by_country_by_month` | flattened | nested   |
| `key_executives`                      | flattened | nested   |
| `key_executive_arrivals`              | flattened | nested   |
| `key_executive_departures`            | flattened | nested   |

***

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="BrFNqrq8qUru" label="September 23, 2025" color="blue"></option><option value="R4kzybFgtnjf" label="September 24, 2025" color="blue"></option><option value="rE1uTmK1Qykr" label="November 28, 2025" color="blue"></option><option value="rdghCLE1DuW1" label="December 2, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="rdghCLE1DuW1">December 2, 2025</span></td><td>Starting to support Bulk Collect requests for Multi-source Company API</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added endpoints</mark>

| Endpoint                                        | Description                                           |
| ----------------------------------------------- | ----------------------------------------------------- |
| `/v2/data_requests/company_multi_source/ids`    | Uses a list of IDs for bulk data requests             |
| `/v2/data_requests/company_multi_source/es_dsl` | Uses Elasticsearch DSL queries for bulk data requests |

***

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="BrFNqrq8qUru" label="September 23, 2025" color="blue"></option><option value="R4kzybFgtnjf" label="September 24, 2025" color="blue"></option><option value="rE1uTmK1Qykr" label="November 28, 2025" color="blue"></option><option value="rdghCLE1DuW1" label="December 2, 2025" color="blue"></option><option value="EZMkvUqarCyQ" label="December 17, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="EZMkvUqarCyQ">December 17, 2025</span></td><td>Adding one data field to the Search Preview response body. This update improves the visibility of company size directly in preview search results.</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added field</mark>

| Data field        | Description                                                                                  | Data type |
| ----------------- | -------------------------------------------------------------------------------------------- | --------- |
| `employees_count` | Number of employees on Professional network who associated their experience with the company | Integer   |

## Multi-source Employee API

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="BrFNqrq8qUru" label="September 23, 2025" color="blue"></option><option value="R4kzybFgtnjf" label="September 24, 2025" color="blue"></option><option value="rE1uTmK1Qykr" label="November 28, 2025" color="blue"></option><option value="rdghCLE1DuW1" label="December 2, 2025" color="blue"></option><option value="EZMkvUqarCyQ" label="December 17, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="EZMkvUqarCyQ">December 17, 2025</span></td><td>Adding an additional sorting option for both Elasticsearch DSL and Search Preview endpoints.</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added sorting option</mark>

| Sorting field     | Description                                                     | Supported endpoint                                                                                                                                |
| ----------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `followers_count` | Sort employees by their number of followers in descending order | <ul><li><code>/v2/employee\_multi\_source/search/es\_dsl</code></li><li><code>/v2/employee\_multi\_source/search/es\_dsl/preview</code></li></ul> |

## Multi-source Jobs API

<table data-header-hidden><thead><tr><th width="181.5625"><select><option value="Qff9a1ArSsmn" label="September, 2025" color="blue"></option><option value="BrFNqrq8qUru" label="September 23, 2025" color="blue"></option><option value="R4kzybFgtnjf" label="September 24, 2025" color="blue"></option><option value="rE1uTmK1Qykr" label="November 28, 2025" color="blue"></option><option value="rdghCLE1DuW1" label="December 2, 2025" color="blue"></option><option value="EZMkvUqarCyQ" label="December 17, 2025" color="blue"></option></select></th><th></th></tr></thead><tbody><tr><td><span data-option="EZMkvUqarCyQ">December 17, 2025</span></td><td>Adding an additional sorting option for both Elasticsearch DSL and Search Preview endpoints.</td></tr></tbody></table>

### &#x20;<mark style="color:$success;">Added sorting option</mark>

| Sorting field             | Description                                                            | Supported endpoint                                                                                                                      |
| ------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `company_employees_count` | Sort job postings by the company's employee count  in descending order | <ul><li><code>/v2/job\_multi\_source/search/es\_dsl</code></li><li><code>/v2/job\_multi\_source/search/es\_dsl/preview</code></li></ul> |
