# JobTeaser Scraper: Internships and Graduate Jobs (`santamaria-automations/jobteaser-jobs-scraper`) Actor

Scrape student and graduate job ads from JobTeaser: internships, apprenticeships, graduate programmes and entry-level jobs across Europe, with company, location, contract, duration, start date and posting date. Pay-per-result.

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

## Pricing

Pay per event

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 Scraper

Scrape job ads from JobTeaser ([jobteaser.com](https://www.jobteaser.com/)), the career platform for students and graduates in Europe. You get internships, apprenticeships, graduate programmes, student jobs and entry-level jobs with the title, company, place, contract type, duration, start date and posting date. Search by keyword or paste result pages of the site. The data comes from the result list, so no job pages are read and a run stays cheap.

### What you get

- One row per ad, with the contract code (internship, cdi, part_time, alternating, vie, graduate_program), the contract text with the duration, the duration in months and the start month.
- The place with city, region, country and coordinates, the company with its id and logo, the ISO posting date and the way to apply (on the employer site or through JobTeaser).
- Each ad once per run, even when several keywords find it.
- A run with no input returns 20 ads for the keyword marketing.
- No salary and no remote flag: the result list does not show them, and the ad texts are not read.

### Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client: Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

**Apify MCP server URL:**

`https://mcp.apify.com?tools=santamaria-automations/jobteaser-jobs-scraper`

**Example prompt once connected:**

> "Use `jobteaser-jobs-scraper` to find up to 50 ads for the keyword "marketing" on JobTeaser. Return results as a table with title, company, location and job URL."

Clients that support dynamic tool discovery (Claude.ai, VS Code) receive the full input schema automatically.

### Input

Every field is optional. Example:

```json
{
  "maxResults": 20,
  "maxResultsPerQuery": 20,
  "searchQueries": [
    "marketing"
  ]
}
```

| Field | What it does |
|---|---|
| `searchQueries` | Keywords such as marketing, finance, data or software engineer. Each keyword is its own search. Empty (and no start address) lists the newest ads. |
| `startUrls` | Result pages of jobteaser.com, for example https://www.jobteaser.com/fr/job-offers?q=marketing. The language in the address sets the language of the contract text. Other addresses are skipped. |
| `maxResultsPerQuery` | Ads per keyword or start address. Default 50, up to 1000 (the site shows 50 pages at most). |
| `maxResults` | Ads in total. Default 200. 0 means no limit. |

### Sample output

```json
{
  "id": "ce0a7936-d86a-45eb-a3a4-3bebb7a3b26c",
  "slug": "ce0a7936-d86a-45eb-a3a4-3bebb7a3b26c-natixis-stage-6-mois-product-owner-lcnc-data-f-h",
  "title": "Stage - 6 mois - Product Owner LCNC Data F/H",
  "company_name": "Natixis",
  "company_id": "6057ce4c-de79-470c-9240-5485b42776ea",
  "company_logo": "https://d1guu6n8gz71j.cloudfront.net/system/asset/logos/339033/logo.png?1689685002",
  "location": "Paris, France",
  "city": "Paris",
  "region": "Île-de-France",
  "sub_region": "Paris",
  "country": "France",
  "latitude": 48.8575475,
  "longitude": 2.3513765,
  "place_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
  "contract_type": "internship",
  "contract_label": "Internship 5 to 6 months",
  "duration_min_months": 5,
  "duration_max_months": 6,
  "start_date": "2027-01",
  "date_posted": "2026-11-10T13:48:58.000Z",
  "apply_type": "external",
  "sponsored": true,
  "premium": false,
  "publication_type": "sponsored_credit",
  "publication_score": 100,
  "partner_school_ids": [
    "0bfcb89a-286b-434a-a143-a13dac5e8b9e"
  ],
  "page": 1,
  "position": 0,
  "job_url": "https://www.jobteaser.com/en/job-offers/ce0a7936-d86a-45eb-a3a4-3bebb7a3b26c-natixis-stage-6-mois-product-owner-lcnc-data-f-h",
  "search_query": "marketing",
  "source": "jobteaser.com",
  "scraped_at": "2026-11-10T15:32:38Z"
}
```

### Fields

All fields come from the result list. There are no detail-only fields.

| Field | Type | Description |
|---|---|---|
| `id` | string | The ad id (UUID) in the ad address /<language>/job-offers/<id>-<slug>. It is the dedup key. |
| `slug` | string | Last part of the ad address: the id followed by the text of the title. |
| `title` | string | Job title as shown on the ad. |
| `company_name` | string, null | Hiring company as shown on the ad. |
| `company_id` | string, null | JobTeaser id of the company. |
| `company_logo` | string, null | Logo image URL of the company. |
| `location` | string, null | Place of the ad as the site writes it. |
| `city` | string, null | City of the place. |
| `region` | string, null | Region or state of the place. |
| `sub_region` | string, null | Department or county of the place. |
| `country` | string, null | Country of the place, in the language of the page. |
| `latitude` | number, null | Latitude of the place. |
| `longitude` | number, null | Longitude of the place. |
| `place_id` | string, null | Place id of the site for the location. |
| `contract_type` | string, null | Contract code of the site: internship, cdi, part_time, alternating, vie, graduate_program, and others. |
| `contract_label` | string, null | Contract text of the card in the language of the page, with the duration. |
| `duration_min_months` | integer, null | Shortest duration in months. Empty for open-ended contracts. |
| `duration_max_months` | integer, null | Longest duration in months. Empty for open-ended contracts. |
| `start_date` | string, null | Planned start as year-month (YYYY-MM). Empty when the ad gives none. |
| `date_posted` | string, null | When the ad went live (ISO 8601, UTC). |
| `apply_type` | string, null | external when the candidate applies on the employer site, internal when the application goes through JobTeaser. |
| `sponsored` | boolean | True when the ad sits in a Job of the week slot. |
| `premium` | boolean | True for a premium ad. |
| `publication_type` | string, null | How the ad was bought: sponsored_credit, premium_credit, standard_credit or free. |
| `publication_score` | integer, null | Ranking weight of the publication type. |
| `partner_school_ids` | array | Ids of the partner schools the ad is shown to. Empty when none are listed. |
| `page` | integer | Result page of the search where the ad was read. |
| `position` | integer, null | Position of the ad on its result page, counted from 0. |
| `job_url` | string | Public address of the ad on JobTeaser. |
| `search_query` | string | The keyword or start address that found the ad. |
| `source` | string | Site host. |
| `scraped_at` | string | When the ad was read (ISO 8601, UTC). |

### Limits

JobTeaser blocks datacenter and residential IPs, so this Actor needs the Apify UNBLOCKER proxy group, which your Apify plan may not include. When the platform refuses that group, the run stops at once with exit code 1, the status says so, 0 jobs are delivered and no job result is charged.

### Pricing

This Actor uses pay per event. There is a small `apify-actor-start` event when a run starts and one `job-result` event for each ad in the dataset. You are never charged for an ad twice, and a run stops when it reaches the maximum charge you set.

Price: $0.001 start fee per run, then $0.0009 per job result ($0.90 per 1,000 jobs).

**New to Apify?** Every account gets a $5 free monthly platform credit, enough to try this actor at no cost.

### Related Actors

- [Welcome to the Jungle Jobs Scraper: WTTJ Salaries & Tech](https://apify.com/santamaria-automations/welcome-to-the-jungle-scraper): Jobs from Welcome to the Jungle, strong in France and tech.
- [e-fellows.net Scraper - DACH Elite Graduate Jobs](https://apify.com/santamaria-automations/e-fellows-scraper): Graduate and student jobs from e-fellows.net.
- [TargetJobs UK Scraper: Graduate Jobs & Interns](https://apify.com/santamaria-automations/targetjobs-uk-scraper): Graduate jobs and internships from TargetJobs UK.
- [Prospects.ac.uk Scraper: UK Graduate Jobs & Internships](https://apify.com/santamaria-automations/prospects-uk-scraper): UK graduate jobs and internships from Prospects.ac.uk.

### FAQ

**Can I filter by location or contract type?**
Not in the input. Every row carries `country`, `city`, `region`, `contract_type` and `duration_min_months`, so you can filter the dataset after the run.

**Why is there no job description?**
The ad text sits on the job page. Reading it for every ad would cost more than a result is priced, so this Actor delivers the list data. Use `job_url` to open an ad.

**What happens when a keyword finds nothing?**
The run ends normally with the status "0 jobs found for <keyword>." and nothing is charged.

**Why do some ads have no start date or duration?**
Open-ended contracts and student jobs carry no duration, and many ads give no start month. Then `duration_min_months`, `duration_max_months` and `start_date` are `null`.

### Support

Something broken, or a field you wish this Actor returned? Open a ticket on the Actor's [Issues tab](https://apify.com/santamaria-automations/jobteaser-jobs-scraper/issues) or email contact@nanoscrape.com. We usually respond within one working day.

# Changelog

This Actor's version history is a separate document: https://apify.com/santamaria-automations/jobteaser-jobs-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords such as marketing, finance, data or software engineer. Each keyword runs as its own search on JobTeaser; an ad found by several keywords is returned once. Leave empty (and give no start address) to list the newest ads.

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

Result pages copied from jobteaser.com, in the form https://www.jobteaser.com/en/job-offers or https://www.jobteaser.com/fr/job-offers?q=marketing. The language in the address sets the language of the contract text. Other query parameters of the address are passed on as they are. Addresses of single ads or of other sites are skipped.

## `maxResultsPerQuery` (type: `integer`):

Most ads read for each keyword or start address. 0 means no limit. Up to 1000, the site shows at most 50 pages.

## `maxResults` (type: `integer`):

Most ads for the whole run. 0 means no limit.

## Actor input object example

```json
{
  "maxResultsPerQuery": 50,
  "maxResults": 200
}
```

# Actor output Schema

## `jobs` (type: `string`):

Dataset with the scraped JobTeaser job ads.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("santamaria-automations/jobteaser-jobs-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("santamaria-automations/jobteaser-jobs-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 '{}' |
apify call santamaria-automations/jobteaser-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/jobteaser-jobs-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/WDbS3biwrMzH5pnqo/builds/IHtYUl7QokEGlVec8/openapi.json
