# JobTeaser Jobs Scraper - Internships, Apprenticeships, Jobs (`topapi/jobteaser-scraper`) Actor

Scrape JobTeaser jobs, internships and apprenticeships: title, company, place with coordinates, contract and duration, start, salary, full description, apply link, employer legal ID and size. Keywords, places, links, companies, every JobTeaser filter, monitor mode. $0.71 per 1,000 jobs.

- **URL**: https://apify.com/topapi/jobteaser-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.71 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## JobTeaser Jobs Scraper

Scrape jobs, internships, apprenticeships, graduate programmes and VIE placements from **JobTeaser**, the European early-career job board. Type a keyword and a place, or paste JobTeaser links, and click **Start**. Each job comes back as one row with the company, the place with coordinates, the contract and its length, the start date, the posting date and, with full details (on by default, same price), the full description, the employer's own apply link, the salary as numbers (also yearly), the expiry date, the job category, the remote policy, the study level and experience asked for, and the employer's legal name, legal ID (SIREN in France), type, size and sectors.

- **No login, no cookies to bring, no proxy needed.** The actor reads the same public pages JobTeaser's own site loads.
- **Full details at no extra charge.** Description (text, HTML and Markdown), apply link, salary, dates, category, remote policy, study level, experience and employer details are in the job price.
- **Every JobTeaser filter.** Place and radius, contract type, contract duration, remote work, study level, work experience, company type, company sector, job category, job ad language, start date, simplified application, jobs with impact and sort go into JobTeaser's own search, so a narrow search costs nothing extra.
- **Past the 1,000-job limit.** JobTeaser lists only the first 1,000 jobs of a search. **Maximize coverage** splits a bigger search by contract type, company type and date order (2,924 jobs instead of 1,000 for `marketing` in our test).
- **Company pages and company profiles.** Every job a company lists, and (optional, same price) the company's website, headquarters, founding year, countries, average employee age, values and gender parity.
- **No repeats.** JobTeaser shows the same "job of the week" ads on top of every search page; every job ID comes back once per run, and `jobOfTheWeek` marks them.
- **Monitor mode.** Schedule it and get only the jobs that are new since the last run, with alerts to Slack, Discord, Teams, Telegram, ntfy or your webhook.

### What does one row contain?

One real row from a run on 15 November 2026 (keyword `marketing`; long text shortened):

```json
{
  "jobId": "6e51e72f-b02b-4957-aa8e-bafe46816e62",
  "title": "Stage - CRM et Marketing Digital",
  "url": "https://www.jobteaser.com/en/job-offers/6e51e72f-b02b-4957-aa8e-bafe46816e62-numberly-stage-crm-et-marketing-digital",
  "company": "Numberly",
  "companyId": "a4872e91-865d-4a89-8c8d-c96795396c49",
  "companyLogoUrl": "https://d1guu6n8gz71j.cloudfront.net/system/asset/logos/25844/logo.png?1770370064",
  "location": "Paris, France",
  "city": "Paris",
  "subRegion": "Paris",
  "region": "Île-de-France",
  "country": "France",
  "latitude": 48.8575475,
  "longitude": 2.3513765,
  "placeId": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
  "locations": ["Paris, France"],
  "locationCount": 1,
  "contractType": "internship",
  "contractLabel": "Internship 5 to 6 months",
  "contractDurationMinMonths": 5,
  "contractDurationMaxMonths": 6,
  "startPeriod": "2027_01",
  "startLabel": "2027-01",
  "startDate": "2027-01-01T00:00:00Z",
  "immediateStart": true,
  "postedAt": "2026-11-13T09:57:57.000Z",
  "firstPublishedAt": "2026-11-13T09:57:57.783Z",
  "daysSincePosted": 2,
  "validThrough": "2026-12-13T09:57:57.783Z",
  "applicationDeadline": null,
  "remoteType": "partial",
  "remoteTypeCode": "REMOTE_TYPE_PARTIAL_ALLOWED",
  "jobLocationType": "TELECOMMUTE",
  "jobCategory": "Marketing & Webmarketing",
  "jobCategoryId": "5b32bd97-8d4f-4d30-97a4-46fcc76d8339",
  "jobCategories": ["Marketing & Webmarketing"],
  "languageCode": "fr",
  "studyLevel": "Master level or equivalent",
  "studyLevelCode": "STUDY_LEVEL_MASTER",
  "studyLevelCodes": ["STUDY_LEVEL_MASTER"],
  "educationRequirement": "postgraduate degree",
  "workExperience": "Student / recent graduate",
  "workExperienceCode": "young_graduate",
  "employmentTypes": ["INTERN"],
  "salaryText": "1300-1600 EUR per month",
  "salaryMin": 1300,
  "salaryMax": 1600,
  "salaryCurrency": "EUR",
  "salaryPeriod": "month",
  "salaryYearlyMin": 15600,
  "salaryYearlyMax": 19200,
  "description": "Numberly est reconnu comme l’un des meilleurs spécialistes mondiaux du Data Marketing avec près de 500 collabo...",
  "descriptionHtml": "<p>Numberly est reconnu comme l’un des meilleurs spécialistes mondiaux du Data Marketing avec près de 500 coll...",
  "descriptionMarkdown": "Numberly est reconnu comme l’un des meilleurs spécialistes mondiaux du Data Marketing avec près de 500 collabo...",
  "contactEmails": [],
  "contactPhones": [],
  "easyApply": false,
  "candidacyType": "EXTERNAL",
  "applicationType": "external_application",
  "applyUrl": "https://joinus.numberly.com/jobs/4555486-stage-crm-et-marketing-digital/applications/new?promotion=2294683-jobteaser-new",
  "externalId": "4555486",
  "directApply": false,
  "applicationFlowEnabled": true,
  "aiValidationAllowed": false,
  "candidacyMessageType": null,
  "companyLegalName": "Numberly",
  "companyLegalId": "517495933",
  "companyBusinessType": "large",
  "companyBusinessTypeLabel": "Large company",
  "companySize": "500 employees",
  "companyIndustry": "Digital / E-commerce",
  "companyMainSector": "digital_e_commerce",
  "companySectors": ["digital_e_commerce", "communication_advertising"],
  "companyIndustryIds": ["4e69c5c1-6d12-400c-8a91-d7e2eb33255c", "6a6ce28e-c0e1-40e8-8730-3a8f03522b33"],
  "companyShortDescription": "Marketing Technologist",
  "companyCoverUrl": "https://d1guu6n8gz71j.cloudfront.net/system/asset/covers/8792415/original.png?1739294549",
  "companySlug": "1000mercis",
  "companyUrl": "https://www.jobteaser.com/en/companies/1000mercis",
  "companyJobsUrl": "https://www.jobteaser.com/en/companies/1000mercis/job-offers",
  "featured": false,
  "premium": false,
  "jobOfTheWeek": false,
  "publicationType": "premium_credit",
  "publicationScore": 200,
  "exclusive": false,
  "privateOffer": false,
  "createdByStudentOrAlumni": false,
  "postedByPartnerCompany": false,
  "careerCenterName": "JobTeaser",
  "partnerSchoolIds": ["137038a9-e616-4c10-beea-7041204580dc", "8a723a3a-f801-4cf9-9f58-13d213ec090f"],
  "active": true,
  "creationSource": "teamtailor",
  "careerCenterStatus": "CAREER_CENTER_STATUS_ACCEPTED",
  "contentFingerprint": "4dd31109ecb706aa",
  "searchQuery": "marketing",
  "searchLocation": null,
  "searchUrl": "https://www.jobteaser.com/en/job-offers?q=marketing",
  "searchIndex": "job_ads_search_en",
  "siteLanguage": "en",
  "pageNumber": 1,
  "position": 5,
  "detailsFetched": true,
  "companyProfileFetched": false,
  "slug": "6e51e72f-b02b-4957-aa8e-bafe46816e62-numberly-stage-crm-et-marketing-digital",
  "scrapedAt": "2026-11-15T19:33:01.061Z"
}
```

With **Include company profile** on, each row also carries `companyWebsite`, `companyHeadquarters`, `companyDescription`, `companyFoundedYear`, `companyCountryCount`, `companyAverageEmployeeAge`, `companyValues`, `companyParity` (`{ "women": "40%", "men": "60%" }`) and `companyKeyFacts`.

#### Every field

| Field | What it is |
|---|---|
| `jobId`, `url`, `slug` | JobTeaser's job ID, the job page and the job part of its link. One row per job per run. |
| `title` | Job title as posted |
| `company`, `companyId`, `companyLogoUrl` | Employer, its JobTeaser ID and logo |
| `location`, `city`, `subRegion`, `region`, `country`, `latitude`, `longitude`, `placeId` | Place as JobTeaser writes it, its parts, coordinates and Google place ID |
| `locations`, `locationCount` | Every place of the job (a job can have several) |
| `contractType`, `contractLabel` | internship, alternating (apprenticeship), cdd (fixed-term), cdi (full-time), graduate_program, vie, part_time, thesis, freelance, master_thesis or industry_master_job, and the contract as JobTeaser shows it ("Internship 6 months") |
| `contractDurationMinMonths`, `contractDurationMaxMonths` | Contract length in months |
| `startPeriod`, `startLabel`, `startDate`, `immediateStart` | Start: JobTeaser's code ("0" = as soon as possible, else YYYY_MM), as text, the exact date when the employer set one, immediate start |
| `postedAt`, `firstPublishedAt`, `daysSincePosted`, `validThrough`, `applicationDeadline` | When the job went live, when it was first published, days since, when the ad expires, the deadline when set |
| `remoteType`, `remoteTypeCode`, `jobLocationType` | Remote policy: full, partial or none |
| `jobCategory`, `jobCategoryId`, `jobCategories` | JobTeaser job category (the Job category filter value) |
| `languageCode` | Language of the job ad |
| `studyLevel`, `studyLevelCode`, `studyLevelCodes`, `educationRequirement` | Study level asked for |
| `workExperience`, `workExperienceCode` | Experience asked for |
| `employmentTypes` | schema.org employment types (INTERN, FULL_TIME...) |
| `salaryText`, `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` | Salary as one line and as numbers per hour, day, week, month or year |
| `salaryYearlyMin`, `salaryYearlyMax` | The same pay as a yearly figure (month x 12, week x 52, day x 220, hour x 1,760) |
| `description`, `descriptionHtml`, `descriptionMarkdown` | Full description as text, HTML and Markdown (choose with **Description format**) |
| `contactEmails`, `contactPhones` | Emails and phone numbers written in the description |
| `easyApply`, `candidacyType`, `applicationType` | Apply on JobTeaser itself (simplified application) or on the employer's site |
| `applyUrl`, `externalId` | The employer's own apply link and the job's reference in the employer's system |
| `directApply`, `applicationFlowEnabled`, `aiValidationAllowed`, `candidacyMessageType` | JobTeaser's application settings for the job |
| `companyLegalName`, `companyLegalId` | Employer's legal name and legal ID when JobTeaser has one (SIREN in France) |
| `companyBusinessType`, `companyBusinessTypeLabel`, `companySize`, `companyIndustry`, `companyMainSector`, `companySectors`, `companyIndustryIds` | Employer type ("Large company"), head count ("37k employees"), industry and sector codes |
| `companyShortDescription`, `companyCoverUrl`, `companySlug`, `companyUrl`, `companyJobsUrl` | Employer's one-liner, cover image and JobTeaser company page and job list |
| `companyWebsite` ... `companyKeyFacts` | Company profile fields (Include company profile) |
| `featured`, `premium`, `jobOfTheWeek`, `publicationType`, `publicationScore` | Paid placements: premium, or a "job of the week" ad |
| `exclusive`, `privateOffer`, `createdByStudentOrAlumni`, `postedByPartnerCompany`, `careerCenterName`, `partnerSchoolIds` | JobTeaser listing flags and the partner schools the job is shown to |
| `active`, `creationSource`, `careerCenterStatus` | The job is live; how it reached JobTeaser (multiposting, an applicant tracking system...) |
| `changeType`, `firstSeenAt`, `lastSeenAt`, `monitoringStateKey` | Monitor mode only: NEW, UPDATED, DETAILS or UNCHANGED, and when the job was first and last seen |
| `contentFingerprint` | Hash of title, company, place, contract and start (what monitor mode compares) |
| `searchQuery`, `searchLocation`, `searchUrl`, `searchIndex`, `siteLanguage`, `pageNumber`, `position` | Which search found the job and where it stood in the results |
| `detailsFetched`, `companyProfileFetched` | True when the job page / company page was read |
| `scrapedAt` | When this run read the job |

#### How full are the fields?

Measured on a 1,000-job run on 15 November 2026 (`marketing`, full details on):

| Filled for | Fields |
|---|---|
| 99-100% | job ID, title, link, company, location, country, coordinates, contract type and label, start, posted, first published, expiry, category, job ad language, study level, experience, employment type, description (all three formats), easy apply, legal name, all listing flags |
| 80-99% | city 95.2%, region 91.4%, company sectors 87.6%, education requirement 85.4%, logo 85.0%, apply link 84.7% (the others apply on JobTeaser), sub-region 84.6%, company type 82.5%, industry 80.7% |
| 50-80% | contract length 79%, employer reference 78.4%, main sector 73.1%, company page 68.9%, one-line description 66.4%, company size 65.1%, partner schools 57.7% |
| under 50% | remote policy 47.9%, exact start date 45.1%, legal ID 33.0%, salary 22.8%, emails in the description 5.2%, phones 3.6%, application deadline 0.5% |

A field JobTeaser does not give for a job is `null` (or `[]` for lists), never a made-up value. JobTeaser's position category was empty on all 1,000 jobs, so it is not a field.

### How to use it

1. Type one or more **Keywords** (each keyword is its own search) and, if you want, **Places** (each place is its own search for every keyword). Places are what JobTeaser's location box takes: a city or postcode (searched within the **Radius**, 30 km by default), a region (`Île-de-France`, `Bavaria, Germany`) or a country (`Germany`). Leave Places empty for all of JobTeaser.
2. Set any **JobTeaser filters** you want.
3. Set **Maximum jobs** (100 by default; 0 = no limit) and click **Start**.

Or paste **JobTeaser links**: a search with your filters (`https://www.jobteaser.com/en/job-offers?q=marketing&contract=internship`), a job (`https://www.jobteaser.com/en/job-offers/<id>-...`) or a company (`https://www.jobteaser.com/en/companies/ferrero`). School career-centre links work too. **Companies** takes company names as they appear in their JobTeaser link (`ferrero`, `commerzbank`), and **Job IDs** takes job IDs.

Examples:

```json
{ "queries": ["data analyst", "business analyst"], "locations": ["Paris", "Lyon"], "contractTypes": ["internship"], "maxItems": 500 }
```

```json
{ "queries": ["engineer"], "locations": ["Germany"], "studyLevels": ["4"], "workExperience": ["young_graduate"], "postedWithin": "7d" }
```

```json
{ "companies": ["commerzbank", "ferrero"], "includeCompanyProfile": true, "maxItems": 0 }
```

#### JobTeaser's own filters (free to read)

| Input | Values |
|---|---|
| `locations` + `radius` | city, postcode, region or country; radius 5, 10, 20, 30 or 50 km around a city |
| `contractTypes` | internship, alternating (apprenticeship), cdd, cdi, graduate_program, vie, part_time, thesis, freelance, master_thesis, industry_master_job |
| `contractDurations` | 3 (1-3 months), 6, 9, 12, 18, 24, 36 (25-48+ months) |
| `remoteTypes` | remote_full, remote_partial |
| `studyLevels` | 1 (none), 6 (secondary), 2 (vocational), 3 (bachelor), 4 (master), 5 (doctorate) |
| `workExperience` | young_graduate, three_to_five_years, six_to_ten_years, more_than_ten_years |
| `companyBusinessTypes` | large, startup, sme, ngo_public_lab, collective |
| `companySectors` | 35 sectors (audit, consultancy, banking_finance, luxury, it_consultancy_it, ...) |
| `jobCategories` | 71 categories and families (a family, such as "Engineering (all)", searches all of its categories) |
| `jobLanguages` | the language the job ad is written in (fr, en, de, es, it, nl, ...) |
| `startDates` | `asap` or a month as YYYY-MM |
| `easyApplyOnly`, `jobWithImpact` | simplified application only; jobs with a social or environmental impact only |
| `sortBy` | relevance or date |

#### More filters (checked before the charge)

`postedWithin` (24h, 7d, 30d: JobTeaser has no date filter, so the actor reads newest first and stops at the window's edge), `excludeKeywords` (title or company), `excludeCompanies`, `companyNames` (only these), `titleMustMatchKeyword`, `skipFeatured` (drop the "job of the week" ads) and `onlyWithSalary`. Jobs these filters remove are never charged. When your filters keep very few of the jobs read, the run stops reading once more pages would cost more than they return, and the status message says so.

#### Details and output

- **Include full details** (on by default, same price): each job's own page adds the description, apply link, salary, dates, category, remote policy, study level, experience, employment type and employer details. Off: the search-card fields only, about five times faster.
- **Include company profile** (off by default, same price): the company page, read once per company.
- **Description format**: text, HTML and Markdown (default), or one of them, or none. **Description length limit** shortens them.
- **Maximum jobs per search** and **Maximum pages per search** (20 jobs a page, 50 pages at most) limit one search.
- **Site language** sets the language of JobTeaser's labels and links in the row; the jobs found are the same.
- **Leave out empty fields** drops `null` and `[]` from each row.

#### Maximize coverage

JobTeaser lists only the first 1,000 jobs of one search (the status message tells you when a search hit that, with JobTeaser's own count). With **Maximize coverage** on, such a search is read again split by contract type, then by company type, and newest first, and only jobs not already delivered are added: `marketing` (4,958 jobs on JobTeaser) gave 2,924 jobs instead of 1,000 in our test.

#### Monitor mode

Switch on **Monitor mode** and schedule the actor (for example daily). The first run delivers what it finds; later runs deliver only jobs that are new, or whose title, company, place, contract or start changed (`changeType`). A run that finds nothing new charges nothing. If an earlier run went out without full details (or without the company profile) and this run asks for them, those jobs come once more with `changeType: "DETAILS"`. Use **Monitor name** to keep two monitors with the same input apart, and **Reset monitor memory** to start over. Add a **Slack**, **Discord**, **Microsoft Teams**, **Telegram**, **ntfy** or **webhook** address to get the new jobs pushed to you after each run.

### Pricing

**$0.71 per 1,000 jobs** ($0.00071 per job row), full details and the company profile included. No start fee. Repeated jobs, jobs removed by your filters, missing job links and jobs earlier monitor runs delivered are never charged. Platform usage is included in the price.

What runs cost in our tests (15 November 2026):

| Run | Jobs | Charged |
|---|---|---|
| One job (`data analyst` in Paris) | 1 | $0.00071 |
| `marketing` (the example input) | 20 | $0.0142 |
| 3 keywords | 150 | $0.1065 |
| `marketing` | 1,000 | $0.71 |
| `marketing`, Maximize coverage on | 2,924 | $2.08 |

Set **Maximum cost per run** in the run options to cap a run: it stops cleanly at the limit and charges only the rows it delivered.

### Limits

- JobTeaser lists the first 1,000 jobs of a search; Maximize coverage, more places or narrower filters reach more.
- JobTeaser refuses heavy traffic from one connection. The actor spreads its requests over several connections by itself; when JobTeaser still refuses a job page, that job goes out with its search-card fields only (`detailsFetched: false`, the status message counts them). In our tests that was 0 to 5 jobs in 150 while five runs ran at once.
- Salary (22.8%), legal ID (33.0%) and remote policy (47.9%) are empty when the employer left them out.
- A place is looked up the way JobTeaser's location box does it; the status message says which place was used ("Lyon" = Lyon, Rhône, France). Add the country when a name is ambiguous.
- About 1,000 jobs with full details take 5 to 6 minutes (with full details off, about a fifth of that). A run of more than ~9,000 jobs needs a longer run timeout than the default hour.

### Integrations and API

Run it from the Apify API, a schedule, Make, Zapier, n8n or any language with the Apify client; the dataset downloads as JSON, CSV, Excel or XML. The input field names of other JobTeaser actors (`keyword`, `keywords`, `location`, `city`, `startUrls`, `url`, `results_wanted`, `maxResults`, `limit`, `contract`, `contractType`, `duration`, `remote_types`, `degree`, `experience`, `company_sectors`, `listing_language`, `locale`, `fetchDetails`, `enrichDetails`, `enrich_data`, `includeCompanyDetails`, `maximize_coverage`, `incrementalMode`, `stateKey`, ...) are accepted as well, so an existing integration keeps working.

# Actor input Schema

## `queries` (type: `array`):

One JobTeaser search per keyword (job title, skill or company name), e.g. "marketing", "data analyst", "stage finance". Combined with every place below.

## `locations` (type: `array`):

Cities, postcodes, regions or countries, as JobTeaser's own location box takes them (e.g. "Paris", "Lyon", "75011", "Île-de-France", "Germany"). A city searches within the radius below. Add the country to tell places apart ("Bavaria, Germany"). Leave empty for everywhere.

## `radius` (type: `integer`):

Applies to a city or postcode in Places. JobTeaser offers 5, 10, 20, 30 or 50 km; other values are rounded to the nearest of these.

## `startUrls` (type: `array`):

Search links (any filters you set on jobteaser.com/en/job-offers), job links (jobteaser.com/en/job-offers/<id>-...) or company links (jobteaser.com/en/companies/<company>). School career-centre links work too.

## `companies` (type: `array`):

Every job a company lists on JobTeaser, by its JobTeaser company name in the link (e.g. "ferrero", "commerzbank") or its company link.

## `jobIds` (type: `array`):

JobTeaser job IDs (the UUID at the start of a job link). Each is read from its own job page.

## `maxItems` (type: `integer`):

Most jobs this run delivers (and charges) in total. 0 = no limit.

## `includeDetails` (type: `boolean`):

Read each delivered job's own page: full description (text, HTML, Markdown), apply link, salary, publication and expiry dates, job category, remote policy, study level, experience, employment type, the employer's legal name, legal ID (SIREN), type, size and sectors. Same price per job.

## `includeCompanyProfile` (type: `boolean`):

Add the employer's JobTeaser company page to each job: website, headquarters, founding year, countries, average employee age, values and gender parity. Read once per company. Same price per job.

## `sortBy` (type: `string`):

JobTeaser's own order: by relevance or newest first.

## `contractTypes` (type: `array`):

Internship, apprenticeship, fixed-term, full-time, graduate programme, VIE, part-time / student job, research / doctorate, freelance, bachelor or master thesis, industry master job.

## `contractDurations` (type: `array`):

Length of internships, apprenticeships and fixed-term contracts.

## `remoteTypes` (type: `array`):

Full remote allowed or remote occasionally allowed.

## `studyLevels` (type: `array`):

The study level the job asks for.

## `workExperience` (type: `array`):

The experience the job asks for.

## `companyBusinessTypes` (type: `array`):

Large company, start-up, SME, government / charity / public, collective.

## `companySectors` (type: `array`):

The employer's sector.

## `jobCategories` (type: `array`):

JobTeaser's job categories (a whole family or one category).

## `jobLanguages` (type: `array`):

The language the job ad is written in.

## `startDates` (type: `array`):

"asap" (as soon as possible) or a start month as YYYY-MM, e.g. 2027-01.

## `easyApplyOnly` (type: `boolean`):

Only jobs you apply to on JobTeaser itself ("Easy apply").

## `jobWithImpact` (type: `boolean`):

Only jobs JobTeaser marks as having a social or environmental impact.

## `postedWithin` (type: `string`):

Only jobs published in this window. JobTeaser has no date filter of its own: the actor reads newest first and stops at the window's edge, so a short window is cheap.

## `siteLanguage` (type: `string`):

The language of JobTeaser's own labels (contract labels, job links). The jobs found are the same.

## `excludeKeywords` (type: `array`):

Skip jobs whose title or company contains any of these words. Checked before the charge.

## `excludeCompanies` (type: `array`):

Skip jobs from companies whose name contains any of these.

## `companyNames` (type: `array`):

Keep only jobs whose company name contains one of these (for every job of one company, use Companies above).

## `titleMustMatchKeyword` (type: `boolean`):

JobTeaser's search also matches descriptions and related words; this keeps only jobs whose title has every word of the keyword.

## `skipFeatured` (type: `boolean`):

JobTeaser shows up to two paid "job of the week" ads on top of every search page, whatever the search. Skip them.

## `onlyWithSalary` (type: `boolean`):

Keep only jobs whose page states a salary (needs full details).

## `maximizeCoverage` (type: `boolean`):

JobTeaser lists only the first 1,000 jobs of one search. On, a bigger search is split by contract type, company type and date order, and the parts are merged without repeats.

## `maxItemsPerSearch` (type: `integer`):

Cap for each keyword x place, link or company. 0 = only the total cap applies.

## `maxPagesPerSearch` (type: `integer`):

Pages of 20 jobs read per search (JobTeaser lists 50 at most).

## `descriptionFormat` (type: `string`):

Which description fields each row carries.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

## `excludeEmptyFields` (type: `boolean`):

Drop fields that are empty for a job instead of writing null.

## `monitorMode` (type: `boolean`):

Deliver only jobs earlier runs with the same input and monitor name did not deliver. A poll with nothing new charges nothing.

## `monitorName` (type: `string`):

Keeps separate memories for separate watches.

## `includeUnchanged` (type: `boolean`):

Monitor mode: also deliver remembered jobs again (changeType UNCHANGED).

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered and start over.

## `webhookUrl` (type: `string`):

POST a JSON message with the new jobs after each run.

## `slackWebhookUrl` (type: `string`):

Slack incoming-webhook URL.

## `discordWebhookUrl` (type: `string`):

Discord channel webhook URL.

## `teamsWebhookUrl` (type: `string`):

Teams incoming-webhook URL.

## `telegramToken` (type: `string`):

Your Telegram bot's token.

## `telegramChatId` (type: `string`):

The chat the bot posts to.

## `ntfyTopic` (type: `string`):

An ntfy.sh topic (or your own ntfy server below).

## `ntfyServer` (type: `string`):

Defaults to https://ntfy.sh.

## `notificationLimit` (type: `integer`):

How many jobs one alert lists.

## `proxyConfiguration` (type: `object`):

Not needed: the actor starts on Apify's own connection and moves to Apify datacenter, then residential proxy by itself when JobTeaser refuses. Set your own proxy here to use it first.

## `maxConcurrency` (type: `integer`):

Job pages read at once.

## Actor input object example

```json
{
  "queries": [
    "marketing"
  ],
  "radius": 30,
  "maxItems": 20,
  "includeDetails": true,
  "includeCompanyProfile": false,
  "easyApplyOnly": false,
  "jobWithImpact": false,
  "postedWithin": "any",
  "siteLanguage": "en",
  "titleMustMatchKeyword": false,
  "skipFeatured": false,
  "onlyWithSalary": false,
  "maximizeCoverage": false,
  "descriptionFormat": "all",
  "excludeEmptyFields": false,
  "monitorMode": false,
  "includeUnchanged": false,
  "resetMonitor": false,
  "notificationLimit": 10,
  "maxConcurrency": 8
}
```

# Actor output Schema

## `results` (type: `string`):

One item per JobTeaser job: title, company, place with coordinates, contract and duration, start, posted date, simplified application, and with full details the description, apply link, salary, expiry, category, remote policy, study level, experience and the employer's legal name, legal ID, type, size and sectors.

## `summary` (type: `string`):

Per-listing counts (JobTeaser's count, pages read, repeats skipped, delivered), filters, places, job-page results and egress. Written when a listing failed or on runs of 1,000+ jobs; every run logs it.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "marketing"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["marketing"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/jobteaser-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "marketing"
  ],
  "maxItems": 20
}' |
apify call topapi/jobteaser-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/jobteaser-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/d3dvTQwRU5uFJv7Zy/builds/V82Fxs8medlMHKbqb/openapi.json
