# Changelog of Career Site Job Listing Feed (`fantastic-jobs/career-site-job-listing-feed`) Actor

- **URL**: https://apify.com/fantastic-jobs/career-site-job-listing-feed/changelog.md
- **Full Actor documentation**: https://apify.com/fantastic-jobs/career-site-job-listing-feed.md

## Changelog

### 2026-06-22 — New filter parameters

Added four new input parameters, matching the latest API:

- **AI Language** (`aiLanguageFilter`) — filter by the AI-detected language of the job description (matches `ai_job_language`).
- **LinkedIn Company Size** (`liOrganizationSizeFilter`) — filter by LinkedIn company-size bucket (e.g. `51-200`; matches `org_linkedin_size`).
- **LinkedIn Industries Exclusion Filter** (`liIndustryExclusionFilter`) — exclude jobs from specific LinkedIn industries.
- **Has No Location** (`hasNoLocation`) — return only jobs with no normalized location (`locations_derived` is null).

> **Update (2026-06-22): all changes in this changelog have now been applied.** The migration to the v1 API is complete — new field and parameter names are live, the deprecated renamed output fields have been removed, and the `old-api` build has been retired. Please make sure your integration uses the new names.

### New Fantastic.jobs API

We're launching our new API on [Fantastic.jobs](https://developer.fantastic.jobs)! This comes with some changes to this Apify Actor as well. Please review the changes below carefully.

Some features of our new API are not available on Apify. Also, if you're retrieving more than 5,000 jobs per month, the API will likely be a better deal:

- ATS, LinkedIn, Y Combinator, and Wellfound jobs combined under a single plan
- An endpoint for modified jobs
- Expired jobs endpoints with hourly refresh, compared to daily refresh on Apify
- Advanced company details with Glassdoor, Crunchbase, and news articles
- Endpoints to count the number of jobs before retrieving them
- Advanced filtering parameters with Boolean search for job title, location, and description
- Much faster response times

If you're interested, start building with the new API: [developer.fantastic.jobs](https://developer.fantastic.jobs)
If not, please carry on below!

### Timeline

#### On 2026-06-08

- All field and parameter changes in this changelog will be applied.
- **If you need more time to switch your infrastructure to accommodate the changes, especially the new `id` format, change the Actor Build to `old-api`.** See Apify's [Builds documentation](https://docs.apify.com/platform/actors/running/runs-and-builds) for how to choose a build. This is the current version of the Actor, and we will keep it active for two additional weeks until 2026-06-22.
- Renamed fields will stay active under both the old and new names until 2026-06-22, so you can use both fields at the same time during the transition. This overlap is only for name changes; removed fields, including `remote_derived`, will be removed on 2026-06-08.

#### On 2026-06-22

- The `old-api` build and deprecated renamed fields will be removed per this changelog.

### Breaking change: `id` is now an integer

The `id` field now returns as an integer instead of a stringified number. If your integration stores IDs as strings, validates response schemas, or compares IDs without type coercion, update that logic before 2026-06-08, or keep using the old built 'old-api' until 2026-06-22 the latest.

Important: `id` was already stored as an integer in the expired endpoints.

### Deprecated input parameter: `remote only (legacy)`

`remote only (legacy)` will be deprecated in favor of `aiWorkArrangementFilter` on 2026-06-08. When enabled, it is translated to `ai_work_arrangement` (`Remote OK` and `Remote Solely`). It is ignored if you set `aiWorkArrangementFilter` explicitly. `remote only (legacy)` will remain available as a deprecated alias with the same functionality.

### Removed input parameter: `includeAi`

The `includeAi` input parameter will be removed on 2026-06-08. AI-enriched fields will be included by default.

### Renamed input parameter: `includeLinkedIn`

`includeLinkedIn` will become `includeCompanyDetails` on 2026-06-08. `includeLinkedIn` will remain available as a deprecated alias with the same functionality, so existing integrations can migrate gradually.

### Deprecated input parameter: `aiHasSalary`

`aiHasSalary` will become `hasSalary` on 2026-06-08. `aiHasSalary` will remain available as a deprecated alias with the same functionality.

### Removed output fields

**`remote_derived` will be removed.** Use `ai_work_arrangement` instead.

### Renamed output fields

| Current field | New field |
| --- | --- |
| `date_validthrough` | `date_valid_through` |
| `locations_raw` | `locations` |
| `locations_alt_raw` | `locations_alt` |
| `location_requirements_raw` | `location_requirements` |
| `salary_raw` | `salary` |
| `ai_salary_minvalue` | `ai_salary_min_value` |
| `ai_salary_maxvalue` | `ai_salary_max_value` |
| `ai_salary_unittext` | `ai_salary_unit_text` |
| `ai_education_requirements` | `ai_education` |
| `linkedin_org_employees` | `org_linkedin_headcount` |
| `linkedin_org_url` | `org_linkedin_website` |
| `linkedin_org_size` | `org_linkedin_size` |
| `linkedin_org_slogan` | `org_linkedin_slogan` |
| `linkedin_org_industry` | `org_linkedin_industry` |
| `linkedin_org_followers` | `org_linkedin_followers` |
| `linkedin_org_headquarters` | `org_linkedin_headquarters` |
| `linkedin_org_type` | `org_linkedin_type` |
| `linkedin_org_foundeddate` | `org_linkedin_founded_date` |
| `linkedin_org_specialties` | `org_linkedin_specialties` |
| `linkedin_org_locations` | `org_linkedin_locations` |
| `linkedin_org_description` | `org_linkedin_description` |
| `linkedin_org_slug` | `org_linkedin_slug` |
| `linkedin_org_recruitment_agency_derived` | `org_linkedin_recruitment_agency_derived` |

### Deprecated output fields

- `organization_logo` will remain available for now but is deprecated on ATS data; prefer `org_logo_permalink`.

### New output fields

- `org_linkedin_name` - Company's full name from LinkedIn.
- `org_crunchbase_categories` - List of Crunchbase categories the company is tagged with.
- `org_crunchbase_total_investment` - Total investment in USD raised by the company according to Crunchbase.
- `org_logo_permalink` - Stable hosted URL for the company's logo.
