# JobTeaser Scraper – Internships, Graduate Jobs & Apply Links (`abotapi/jobteaser-scraper`) Actor
Scrape early-career jobs and internships from JobTeaser across Europe. Search with 16 filters or use JobTeaser URLs. Returns title, company, employer profile, locations with coordinates, contract, salary, real external apply link, dates, and full description.
- **URL**: https://apify.com/abotapi/jobteaser-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** Jobs, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.80 / 1,000 job scrapeds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## JobTeaser Jobs Scraper
Collect early-career jobs and internships from JobTeaser, Europe's leading young-talent career platform. Search by keyword, location, and sixteen site filters, or paste links, and get a deeply structured record per posting: title, hiring company with taxonomy and optional full employer profile, every location with coordinates, contract and duration, study level, experience, salary, application channel with the real external apply link, publication dates, and the complete description in text, HTML, and structured rich-text form.
### Why this scraper
- Deep records: 140+ fields per job across company, locations, contract, classification, requirements, work arrangement, compensation, application, dates, status, and content groups.
- Employer profiles on demand: attach each company's public profile: headcount, sector, founding year, culture, values, social links, photo gallery, hiring FAQ, diversity figures, and impact labels, fetched once per company.
- The real apply link: external postings carry the employer's own application URL and external requisition id, not just the listing page.
- Sixteen filters: contract type, duration, remote policy, study level, experience, company type, industry, job category, listing language, start date, application flow, impact companies, international jobs, plus keyword, location with radius, and site language.
- Multi-keyword search and coverage fan-out: run several queries in one go, and optionally fan a broad search out across contract types when a single result list hits the site's display cap.
- Three URL kinds in URL mode: search-result pages, job-detail pages, and company-profile pages.
- Optional export: pipe results straight into Notion, Linear, Airtable, or Apify via MCP connectors.
### Data you get
> Sample shape, values are illustrative placeholders, not from a live listing.
```json
{
"id": "00000000-0000-0000-0000-000000000000",
"title": "Sample Business Developer",
"url": "https://www.jobteaser.com/en/job-offers/00000000-0000-0000-0000-000000000000-sample",
"company": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "Sample Company",
"legal_name": "Sample Company SAS",
"legal_id": "000000000",
"profile_url": "https://www.jobteaser.com/en/companies/sample-company",
"logo_url": "https://media.example.com/logo.png",
"cover_image_url": "https://media.example.com/cover.jpg",
"short_description": "What the employer says about itself."
},
"company_profile": {
"summary": "What the employer says about itself.",
"type_label": "Start-up",
"size_label": "200 employees",
"industry_label": "Recruitment/Training"
},
"company_taxonomy": {
"business_type_code": "startup",
"main_sector_code": "recruitment_training",
"sector_codes": ["recruitment_training"],
"industry_ids": ["00000000-0000-0000-0000-000000000000"],
"space_visibility": "SPACE_VISIBILITY_FULL"
},
"primary_location": {
"label": "Cologne, Germany",
"address": "Cologne, Germany",
"city": "Cologne",
"region": "North Rhine-Westphalia",
"sub_region": "Cologne",
"country": "Germany",
"place_id": "ChIJxxxxxxxxxxxxxxxxxxxxxxx",
"latitude": 50.93,
"longitude": 6.96
},
"locations": [ { "...": "every posting location, same shape" } ],
"google_locations": [ { "...": "normalized places from the detail page" } ],
"contract": { "label": "Full time position", "code": "cdi", "duration_min_months": null, "duration_max_months": null },
"classification": {
"category_name": "Sales & Business Development",
"category_id": "00000000-0000-0000-0000-000000000000",
"department": "Sales & Business Development",
"language_code": "de",
"work_experience_code": "three_to_five_years",
"employment_types": ["FULL_TIME"]
},
"requirements": {
"study_level": "Bachelor level or equivalent",
"study_level_code": "STUDY_LEVEL_BACHELOR",
"study_level_codes": ["STUDY_LEVEL_BACHELOR"],
"education_requirement": "bachelor degree",
"applicant_location_requirements": "Germany"
},
"work_arrangement": {
"job_location_type": "TELECOMMUTE",
"remote_policy": "Partial",
"remote_policy_code": "REMOTE_TYPE_PARTIAL_ALLOWED",
"remote_policy_type": "partially_remote"
},
"compensation": {
"display_text": "80000 EUR - 90000 EUR / annually",
"min": 80000, "max": 90000, "currency": "EUR",
"frequency": "WAGE_FREQUENCY_YEARLY", "status": "has_wage"
},
"application": {
"direct_apply": false,
"type": "external_application",
"channel_code": "CANDIDACY_TYPE_EXTERNAL",
"external_url": "https://careers.example.com/job/000",
"external_id": "00000000"
},
"dates": {
"published_at": "2026-01-01T00:00:00Z",
"expected_archive_at": "2026-02-01T00:00:00Z",
"application_deadline": "As long as the job is online",
"start_date": "As soon as possible",
"immediate_start": true
},
"status": { "is_active": true, "premium": false, "private_offer": false, "exclusive": false },
"content": {
"description_text": "Plain-text description.",
"description_html": "Full HTML description.
",
"description_rich_text": [ { "...": "structured blocks" } ],
"employer_overview": "Employer pitch line."
},
"media": [ { "type": "imageobject", "url": "https://media.example.com/photo.jpg" } ],
"company_details": { "...": "60+ employer-profile fields when company enrichment is on" },
"source_context": { "seed_type": "search", "page_index": 1, "scraped_at": "2026-01-01T00:00:00+00:00" }
}
````
### How to use
Search with filters:
```json
{
"mode": "search",
"queries": ["data analyst"],
"location": "Paris",
"radius": "30",
"contract": ["internship", "alternating"],
"remoteTypes": ["remote_partial"],
"fetchDetails": true,
"includeCompanyDetails": true,
"maxItems": 100
}
```
Paste URLs (search pages, job pages, or company pages):
```json
{
"mode": "url",
"startUrls": [
"https://www.jobteaser.com/en/job-offers?q=marketing&contract=internship",
"https://www.jobteaser.com/en/job-offers/00000000-0000-0000-0000-000000000000-sample-job",
"https://www.jobteaser.com/en/companies/sample-company"
],
"fetchDetails": true,
"maxItems": 50
}
```
### Input
| Field | Description |
|---|---|
| mode | `search` (keywords + filters) or `url` (paste links). |
| queries | Keywords to search; each runs separately. Empty = browse all jobs matching the filters. |
| locale | Site language for labels: en, fr, de, es, it, nl, sv, da. |
| location | City, region, or country (e.g. `Paris`, `France`). Cities combine with `radius`. |
| radius | 5 to 50 km around a city location. |
| contract | Contract types: internship, apprenticeship, fixed-term, full-time, graduate programme, VIE, part-time, thesis, freelance, and more. |
| contractDuration | Contract length buckets from 1-3 months to 48+ months. |
| remoteTypes | Full remote or partial remote. |
| candidacyType | Simplified on-site application or external application. |
| studyLevels | Required education level, none through doctorate. |
| workExperience | Student/recent graduate up to 10+ years. |
| companyBusinessType | Large company, start-up, SME, public/charity, collective. |
| companySectors | 40+ employer industries (grouped options select the whole group). |
| jobCategories | 60+ job categories and sub-categories. |
| languages | Listing language market (15 languages). |
| startDate | `0` (as soon as possible) or `YYYY_MM` values. |
| abroadOnly / jobWithImpact | International listings only / impact-labelled employers only. |
| startUrls | Search, job-detail, or company-profile URLs (url mode). |
| fetchDetails | Attach the complete description, salary, apply link, and full dates to every job. |
| includeCompanyDetails | Attach the employer's full public profile, fetched once per company. |
| maximizeCoverage | Fan a capped search out across contract types to collect more of the total. |
| maxItems | Total records to return (the run cap). |
| proxy | Connection settings (see below). |
| mcpConnectors | Optionally pipe results into Notion, Linear, Airtable, or Apify. |
### Sorting
JobTeaser orders search results by its own relevance ranking and does not expose public sort controls, so results arrive in site order. Use filters (contract, start date, category) to narrow instead.
### Reviews
JobTeaser does not publish company reviews or ratings on its job or company pages, so review fields are not part of the output. Employer profiles do include the company's Glassdoor profile link when the employer provides one.
### Connection
JobTeaser serves the European market. For reliable results, use Apify Residential proxy with a European country such as FR, DE, or GB. On other connections results may be less reliable, so residential is recommended.
### Plan Requirement
This actor runs on any Apify plan, including the free tier.
### Send results into your apps (MCP connectors)
Optionally pipe every record straight into the apps you already use via Model Context Protocol (MCP) connectors. Authorize a connector under Apify then Settings then API & Integrations, then select it in the `mcpConnectors` input. Notion gets a page per record; Linear, Airtable, and Apify get a best-effort write. Leave it empty to skip.
### Pricing
You are billed per run start, per record returned, per record enriched with its full listing page (only when detail fetching is on), and per unique employer profile fetched (only when company enrichment is on). See the Store listing for current rates.
# Actor input Schema
## `mode` (type: `string`):
search = provide keywords, a location, and filters. url = paste search-result, job-detail, or company-profile URLs.
## `queries` (type: `array`):
One or more job titles, skills, or employer names. Each is searched separately. Leave empty to browse all jobs matching your filters.
## `locale` (type: `string`):
Browsing language of the site (affects labels and localized fields, not which jobs exist).
## `location` (type: `string`):
City, region, or country, e.g. Paris, Berlin, France. Countries filter directly; cities are resolved to coordinates and combined with the radius below.
## `radius` (type: `string`):
Search radius around a city location.
## `contract` (type: `array`):
Limit to one or more contract types.
## `contractDuration` (type: `array`):
Limit by contract length.
## `remoteTypes` (type: `array`):
Limit by remote-work policy.
## `candidacyType` (type: `string`):
Limit by how candidates apply.
## `studyLevels` (type: `array`):
Limit by required education level.
## `workExperience` (type: `array`):
Limit by candidate experience level.
## `companyBusinessType` (type: `array`):
Limit by employer type.
## `companySectors` (type: `array`):
Limit by employer industry.
## `jobCategories` (type: `array`):
Limit by job category or sub-category.
## `languages` (type: `array`):
Limit by the language market of the listing.
## `startDate` (type: `array`):
Expected start dates: 0 = as soon as possible, or year\_month like 2026\_09.
## `abroadOnly` (type: `boolean`):
Keep only listings marked as international opportunities.
## `jobWithImpact` (type: `boolean`):
Keep only listings from employers highlighted for social or environmental impact.
## `startUrls` (type: `array`):
Paste search-result URLs (/job-offers?...), job-detail URLs (/job-offers/-), or company-profile URLs (/companies/).
## `fetchDetails` (type: `boolean`):
Attach the complete description (text, HTML, rich text), salary, apply link, dates, and category to every job. Leave off for lighter search-card results.
## `includeCompanyDetails` (type: `boolean`):
Also fetch each employer's public company profile (size, sector, culture, social links, gallery, FAQ) and attach it to the job record. Fetched once per company.
## `maximizeCoverage` (type: `boolean`):
Collect as many matching listings as possible by fanning the search out across contract types when a single result list hits the site's display cap.
## `maxItems` (type: `integer`):
Total records to return across all searches or URLs. This is the run cap.
## `proxy` (type: `object`):
JobTeaser serves the European market. Use Apify Residential proxy with a European country (FR, DE, GB) for reliable results.
## `mcpConnectors` (type: `array`):
Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify then Settings then API & Integrations, then select it here. Notion gets a page-per-item export; other connectors get a best-effort write. Leave empty to skip. Supported: Notion, Linear, Airtable, Apify.
## `notionParentPageUrl` (type: `string`):
URL or id of the Notion page under which item pages are created. Required only for the Notion export.
## `maxNotifyListings` (type: `integer`):
Cap on items written to each connector per run. Does not affect the dataset.
## Actor input object example
```json
{
"mode": "search",
"queries": [
"data analyst"
],
"locale": "en",
"radius": "30",
"candidacyType": "",
"abroadOnly": false,
"jobWithImpact": false,
"startUrls": [
"https://www.jobteaser.com/en/job-offers?q=marketing"
],
"fetchDetails": true,
"includeCompanyDetails": false,
"maximizeCoverage": false,
"maxItems": 20,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
},
"maxNotifyListings": 50
}
```
# Actor output Schema
## `overview` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"queries": [
"data analyst"
],
"startUrls": [
"https://www.jobteaser.com/en/job-offers?q=marketing"
],
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/jobteaser-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"queries": ["data analyst"],
"startUrls": ["https://www.jobteaser.com/en/job-offers?q=marketing"],
"proxy": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "FR",
},
}
# Run the Actor and wait for it to finish
run = client.actor("abotapi/jobteaser-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"queries": [
"data analyst"
],
"startUrls": [
"https://www.jobteaser.com/en/job-offers?q=marketing"
],
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}' |
apify call abotapi/jobteaser-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=abotapi/jobteaser-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "JobTeaser Scraper – Internships, Graduate Jobs & Apply Links",
"description": "Scrape early-career jobs and internships from JobTeaser across Europe. Search with 16 filters or use JobTeaser URLs. Returns title, company, employer profile, locations with coordinates, contract, salary, real external apply link, dates, and full description.",
"version": "1.0",
"x-build-id": "BjJcm9fMEVLOgiK1j"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/abotapi~jobteaser-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-abotapi-jobteaser-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/abotapi~jobteaser-scraper/runs": {
"post": {
"operationId": "runs-sync-abotapi-jobteaser-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/abotapi~jobteaser-scraper/run-sync": {
"post": {
"operationId": "run-sync-abotapi-jobteaser-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"search",
"url"
],
"type": "string",
"description": "search = provide keywords, a location, and filters. url = paste search-result, job-detail, or company-profile URLs.",
"default": "search"
},
"queries": {
"title": "Keywords",
"type": "array",
"description": "One or more job titles, skills, or employer names. Each is searched separately. Leave empty to browse all jobs matching your filters.",
"items": {
"type": "string"
}
},
"locale": {
"title": "Site language",
"enum": [
"en",
"fr",
"de",
"es",
"it",
"nl",
"sv",
"da"
],
"type": "string",
"description": "Browsing language of the site (affects labels and localized fields, not which jobs exist).",
"default": "en"
},
"location": {
"title": "Location",
"type": "string",
"description": "City, region, or country, e.g. Paris, Berlin, France. Countries filter directly; cities are resolved to coordinates and combined with the radius below."
},
"radius": {
"title": "Radius (km)",
"enum": [
"5",
"10",
"20",
"30",
"50"
],
"type": "string",
"description": "Search radius around a city location.",
"default": "30"
},
"contract": {
"title": "Contract types",
"type": "array",
"description": "Limit to one or more contract types.",
"items": {
"type": "string",
"enum": [
"internship",
"alternating",
"cdd",
"cdi",
"graduate_program",
"vie",
"part_time",
"thesis",
"freelance",
"master_thesis",
"industry_master_job"
],
"enumTitles": [
"Internship",
"Apprenticeship",
"Fixed-term Position",
"Full time Position",
"Graduate Programme / Job Rotation Programme",
"International Graduate Business Placements (VIE)",
"Part-time / Student job",
"Research / Doctorate",
"Freelance/Independent",
"Bachelor or Master Thesis",
"Industry Master Job"
]
}
},
"contractDuration": {
"title": "Contract duration",
"type": "array",
"description": "Limit by contract length.",
"items": {
"type": "string",
"enum": [
"3",
"6",
"9",
"12",
"18",
"24",
"36"
],
"enumTitles": [
"1-3 months",
"4-6 months",
"7-9 months",
"10-12 months",
"13-18 months",
"19-24 months",
"25-48+ months"
]
}
},
"remoteTypes": {
"title": "Remote work",
"type": "array",
"description": "Limit by remote-work policy.",
"items": {
"type": "string",
"enum": [
"remote_full",
"remote_partial"
],
"enumTitles": [
"Full remote allowed",
"Remote occasionally allowed"
]
}
},
"candidacyType": {
"title": "Application flow",
"enum": [
"",
"INTERNAL",
"EXTERNAL"
],
"type": "string",
"description": "Limit by how candidates apply.",
"default": ""
},
"studyLevels": {
"title": "Level of study",
"type": "array",
"description": "Limit by required education level.",
"items": {
"type": "string",
"enum": [
"1",
"6",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"No level prerequired",
"Secondary education / High school",
"Vocational / Short-cycle higher education",
"Bachelor level or equivalent",
"Master level or equivalent",
"Doctorate"
]
}
},
"workExperience": {
"title": "Experience",
"type": "array",
"description": "Limit by candidate experience level.",
"items": {
"type": "string",
"enum": [
"young_graduate",
"three_to_five_years",
"six_to_ten_years",
"more_than_ten_years"
],
"enumTitles": [
"Student / Recent graduate",
"3 to 5 years",
"6 to 10 years",
"More than 10 years"
]
}
},
"companyBusinessType": {
"title": "Company type",
"type": "array",
"description": "Limit by employer type.",
"items": {
"type": "string",
"enum": [
"large",
"startup",
"sme",
"ngo_public_lab",
"collective"
],
"enumTitles": [
"Large company",
"Start-up",
"SME",
"Government / Charity / Public / Other",
"Collective"
]
}
},
"companySectors": {
"title": "Industries",
"type": "array",
"description": "Limit by employer industry.",
"items": {
"type": "string",
"enum": [
"audit_consultancy_legal",
"audit",
"consultancy",
"law",
"management_consultancy",
"accounting_services",
"banking_finance_insurance",
"banking_finance",
"insurance",
"construction_real_estate_planning",
"real_estate",
"building_planning",
"architecture",
"retail_consumer_goods_luxury",
"luxury",
"retail",
"consumer_goods",
"energy_environment_utilities",
"energy_utilities",
"environment",
"industrial_agribusiness_chemistry",
"agribusiness",
"aerospace",
"automotive",
"chemistry",
"defense",
"electronics",
"materials",
"other_industries",
"agriculture",
"maritime",
"mechanical_engineering",
"it_telecoms",
"it_consultancy_it",
"telecoms",
"medicine_pharmaceuticals_health_cosmetics",
"cosmetics",
"medicine_pharmaceuticals_health",
"services_transport",
"recruitment_training",
"catering",
"transport_logistics",
"other_services_to_individuals_and_businesses",
"engineering_r_d",
"r_d",
"engineering",
"media_digital_publishing",
"digital_e_commerce",
"media_publishing",
"communication_advertising",
"public_social_ngo_education",
"public_education",
"social_ngo",
"tourism_leisure_culture",
"tourism_hospitality",
"leisure_culture_sports",
"other_category_group",
"other_category"
],
"enumTitles": [
"Audit / Consulting / Legal (all)",
"Audit",
"Consulting",
"Legal",
"Management Consulting",
"Accounting Services",
"Banking / Finance / Insurance (all)",
"Banking / Finance",
"Insurance",
"Construction / Real Estate / Planning / Design (all)",
"Real Estate",
"Building / Planning",
"Architecture / Design",
"Retail / Consumer Goods / Luxury (all)",
"Luxury / Fashion",
"Retail",
"Consumer Goods",
"Energy / Environment / Utilities (all)",
"Energy / Utilities / Oil & Gas",
"Environment",
"Industrial / Food Industry / Chemistry (all)",
"Food & Beverage",
"Aerospace",
"Automotive",
"Chemistry",
"Defense",
"Electronics",
"Materials",
"Other Industries",
"Agriculture / Forest industry",
"Maritime / Railway",
"Mechanical Engineering",
"IT / Telecoms (all)",
"IT / IT Consulting / Software",
"Telecoms",
"Medicine / Pharmaceuticals / Healthcare / Cosmetics (all)",
"Cosmetics",
"Medicine / Pharmaceuticals / Health",
"Services / Transport (all)",
"Recruitment / Training",
"Catering",
"Transport / Logistics",
"Other services to individuals and businesses",
"Engineering / R&D / Design (all)",
"R&D / Design",
"Engineering",
"Media / Digital / Publishing (all)",
"Digital / E-commerce",
"Media / Publishing",
"Communication / Advertising",
"Public / Social / NGO / Education (all)",
"Public / Government / Education / Armed Forces",
"Social / NGO / Charity",
"Events / Tourism / Hospitality / Culture (all)",
"Events / Tourism / Hospitality",
"Leisure / Culture / Sports",
"Other (all)",
"Other"
]
}
},
"jobCategories": {
"title": "Job categories",
"type": "array",
"description": "Limit by job category or sub-category.",
"items": {
"type": "string",
"enum": [
"d8f51c58-e37d-4718-abde-684fb5250f7a",
"50eea788-e140-4e67-85c0-e814d487fd29",
"9038a994-dce5-47f2-8d53-73d1c59c2a3c",
"0f2bf26f-0dde-4f11-aed9-d877d6c43a16",
"88210e98-4cc1-42bf-b4cb-bd39599abab5",
"d9f9bb40-c077-4a13-91f7-ff7092aaee4a",
"a33fd4ee-ec99-4251-be78-69f0a7401961",
"1af1ca55-32c3-4856-a2e0-77c34e26e8a4",
"952999f4-a27f-40d7-8cd0-793bebfef325",
"8535ca80-ed9a-4d0b-9c96-d5c141203367",
"014d3e7d-30c3-47e9-ace6-78c2ed9932fb",
"5b32bd97-8d4f-4d30-97a4-46fcc76d8339",
"202e4df7-1b2c-4283-bf2f-7d945943b42a",
"c6a8d71a-1a9c-46a1-bf98-5b98581d5e03",
"b013338e-9d5e-4784-8196-02618df3d865",
"ef2e56e9-908a-45bd-8942-730d978ba258",
"ce24ca92-05a7-4aea-9895-aa0b5d36c6eb",
"0b6eeb48-4834-42d1-ab11-4f59bfa11cc3",
"f3ac4374-73f6-4378-bc00-c9c1ba998194",
"bebf2262-4c78-4232-9f83-813bb749a847",
"7d0f2f62-abfa-49d9-a1a5-2722d683e68a",
"10803721-d7e6-4f1a-a7b4-85f078c6e457",
"6a11c400-eb69-4fc4-94c7-d2f6f06b0dc9",
"a493d781-1113-4e97-9718-ab2f5a40d698",
"fceeaf77-ebab-4fc6-a30b-291d883fb865",
"441233a0-a478-4762-9bd5-56232fd55c29",
"a945e39a-c5e5-4274-b24b-bcd5e0284fb1",
"746c77de-5ea9-4999-946c-f4c5a44eee83",
"d5da6eaf-2b72-4c6e-893b-46f6aac3e6b4",
"ec7dd50d-c522-4df5-b7e9-ec70b11981d4",
"e82539cb-36db-48d0-b69e-02ca522ee98e",
"4d07fc3c-a3ab-45c9-9d2a-9768a28e2c0a",
"0cbb015a-04c0-4d65-b636-003f24b9d4c4",
"fbab2736-0eea-4d61-899c-161eea6a2b45",
"f3f9d2a0-1b7b-4cca-89b7-5b68af828c40",
"ddc0460c-ce0b-4d98-bc5d-d8829ff9cf11",
"93dcc7d4-b32e-44e1-8346-3a804067d3d0",
"6926e0e4-00ab-477d-b61a-cd2f6d294dcf",
"f149fdec-c5db-4252-9b82-a3bbb29eaf36",
"66296ed0-721c-4d79-bc46-07cc2337d021",
"054bf094-faad-496e-a824-5526998131a6",
"8b524315-b6f0-4ef2-9f68-6ed99a9178e2",
"5d30a267-7f04-4346-9995-18cf972bc865",
"89ccb83a-3b09-41d8-9a07-b7434124ad41",
"06c99647-15b4-4fc3-8665-b7523bb1cea3",
"f6c41f37-b272-4cd6-9941-9d9a357cdf35",
"777cb4c7-d89c-4773-b261-183334a3ce03",
"25454d86-6cb7-4946-814c-1b1a1f5cf0b7",
"39c2620b-4dde-47a1-a87c-bda3c2488705",
"141a2494-80c5-4bae-8865-1ee0f702f441",
"463133db-2588-4e4d-aa73-7a44521f2d69",
"48ebd9d0-78d7-4b93-9632-7262a28f1ec2",
"6e15e854-666e-4224-ab3f-7c04766c55ee",
"7efc44a1-fdf2-4ebc-b7df-d05159d8c3a2",
"b746aa6d-39c0-4a67-ba4f-4d240db60e2f",
"dd5b3dd4-3afd-4173-8873-5b63a1fada75",
"0ba0e1f7-0e19-4f45-91a3-0a77e8b462bb",
"395aefbe-1ea1-48ba-8455-6dc4010cb9eb",
"a0378680-6964-4949-ad7f-2d1a046be7a1",
"74c916b7-aff6-4d72-9592-a754b7d5b34f",
"ec10e43c-5d82-46d4-b835-f77f33b2a528",
"a936325f-8dd4-4c5a-84dd-458538939411",
"10b3006e-a23b-4b45-9752-2fb93db7b13b",
"c2905a50-937d-4387-9b97-836f0c24e709",
"096b42ff-8137-4d31-8f45-bccca136ade3",
"0c5639f3-aba0-44f1-b42a-78703cd9cbf7",
"194a1d04-9560-4cd1-82a9-8dfa217feb2c",
"86d59a72-1ae1-49c3-90f1-2e3caead621c",
"f352bbee-16d4-4a91-beb7-a27c2e1a3dcd",
"cf7ecb56-14f1-4700-90ea-5646d9377f73",
"ca2ca8dc-6802-49f1-888f-e6f887ae15c7"
],
"enumTitles": [
"Engineering (all)",
"Engineering: Architecture & Urban Planning",
"Engineering: Civil Engineering & Structures",
"Engineering: Energy, Materials & Mechanical engineering",
"Engineering: Engineering",
"Engineering: Industrial Design & Engineering",
"Engineering: Technology",
"Business & Management (all)",
"Business & Management: Communication, PR & Events",
"Business & Management: Customer service",
"Business & Management: Management, Consulting & Strategy",
"Business & Management: Marketing & Webmarketing",
"Business & Management: Purchasing",
"Business & Management: Retail",
"Business & Management: Sales & Business Development",
"Finance (all)",
"Finance: Actuarial",
"Finance: Asset Management",
"Finance: Audit",
"Finance: Corporate Finance",
"Finance: Economics",
"Finance: Financial Services",
"Finance: Insurance",
"Finance: Management Control and Accounting",
"Admin, HR & Legal (all)",
"Admin, HR & Legal: Admin",
"Admin, HR & Legal: Corporate law",
"Admin, HR & Legal: Human Resources",
"Admin, HR & Legal: Security & Politics",
"Admin, HR & Legal: Social Law",
"Admin, HR & Legal: Tax law",
"IT & Digital (all)",
"IT & Digital: Electronics & Signal Processing",
"IT & Digital: IT Project, Data & Product Management",
"IT & Digital: Infrastructures, Networks & Telecom",
"IT & Digital: Programming",
"IT & Digital: Web Design & Usability",
"Sciences & R&D (all)",
"Sciences & R&D: Agronomy & Biology",
"Sciences & R&D: Biochemistry & Molecular Biology",
"Sciences & R&D: Biomedical Sciences",
"Sciences & R&D: Chemistry & Processes",
"Sciences & R&D: Environment & Sustainable Development",
"Sciences & R&D: Geography",
"Sciences & R&D: Healthcare and Medicine",
"Sciences & R&D: Laboratory / Analytics",
"Sciences & R&D: Pharmaceutical Research & Biotechnology",
"Sciences & R&D: Research & Development",
"Sciences & R&D: Statistics, Data Analytics & Applied Maths",
"Sciences & R&D: Technology",
"Production & Operations (all)",
"Production & Operations: Construction",
"Production & Operations: Logistics & Supply Chain",
"Production & Operations: Production & Operations",
"Production & Operations: Quality & Maintenance",
"Arts, Culture, Tourism & Hospitality (all)",
"Arts, Culture, Tourism & Hospitality: Culture and the arts",
"Arts, Culture, Tourism & Hospitality: Design & Creative",
"Arts, Culture, Tourism & Hospitality: History / Heritage",
"Arts, Culture, Tourism & Hospitality: Media",
"Arts, Culture, Tourism & Hospitality: Tourism, Hospitality & Food services",
"Health, Social care & Sports (all)",
"Health, Social care & Sports: Medicine",
"Health, Social care & Sports: Odontologist",
"Health, Social care & Sports: Paramedical & Care",
"Health, Social care & Sports: Pharmacy",
"Health, Social care & Sports: Social / Personal & Child care",
"Health, Social care & Sports: Sports",
"Literature & Social Sciences (all)",
"Literature & Social Sciences: Education & Training",
"Literature & Social Sciences: Journalism & Publishing"
]
}
},
"languages": {
"title": "Listing languages",
"type": "array",
"description": "Limit by the language market of the listing.",
"items": {
"type": "string",
"enum": [
"fr",
"en",
"es",
"de",
"da",
"sv",
"ca",
"cs",
"fi",
"gl",
"it",
"no",
"nl",
"pl",
"pt"
],
"enumTitles": [
"French",
"English",
"Spanish",
"German",
"Danish",
"Swedish",
"Catalan",
"Czech",
"Finnish",
"Galician",
"Italian",
"Norwegian",
"Dutch",
"Polish",
"Portuguese"
]
}
},
"startDate": {
"title": "Start dates",
"type": "array",
"description": "Expected start dates: 0 = as soon as possible, or year_month like 2026_09.",
"items": {
"type": "string"
}
},
"abroadOnly": {
"title": "International jobs only",
"type": "boolean",
"description": "Keep only listings marked as international opportunities.",
"default": false
},
"jobWithImpact": {
"title": "Companies with impact only",
"type": "boolean",
"description": "Keep only listings from employers highlighted for social or environmental impact.",
"default": false
},
"startUrls": {
"title": "URLs",
"type": "array",
"description": "Paste search-result URLs (/job-offers?...), job-detail URLs (/job-offers/-), or company-profile URLs (/companies/).",
"items": {
"type": "string"
}
},
"fetchDetails": {
"title": "Fetch full job details",
"type": "boolean",
"description": "Attach the complete description (text, HTML, rich text), salary, apply link, dates, and category to every job. Leave off for lighter search-card results.",
"default": true
},
"includeCompanyDetails": {
"title": "Include employer profiles",
"type": "boolean",
"description": "Also fetch each employer's public company profile (size, sector, culture, social links, gallery, FAQ) and attach it to the job record. Fetched once per company.",
"default": false
},
"maximizeCoverage": {
"title": "Maximize coverage",
"type": "boolean",
"description": "Collect as many matching listings as possible by fanning the search out across contract types when a single result list hits the site's display cap.",
"default": false
},
"maxItems": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Total records to return across all searches or URLs. This is the run cap.",
"default": 20
},
"proxy": {
"title": "Proxy",
"type": "object",
"description": "JobTeaser serves the European market. Use Apify Residential proxy with a European country (FR, DE, GB) for reliable results.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
},
"mcpConnectors": {
"title": "Pipe results into your apps (optional)",
"type": "array",
"description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify then Settings then API & Integrations, then select it here. Notion gets a page-per-item export; other connectors get a best-effort write. Leave empty to skip. Supported: Notion, Linear, Airtable, Apify."
},
"notionParentPageUrl": {
"title": "Notion parent page (Notion connector only)",
"type": "string",
"description": "URL or id of the Notion page under which item pages are created. Required only for the Notion export."
},
"maxNotifyListings": {
"title": "Max items to export per connector",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Cap on items written to each connector per run. Does not affect the dataset.",
"default": 50
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```