# Jobteaser Jobs Search Scraper (`stealth_mode/jobteaser-jobs-search-scraper`) Actor Scrape structured job listing data from JobTeaser.com search pages. Collect titles, locations, contracts, company info, and 18+ fields per listing — perfect for career researchers, university partnerships, and talent market analysts. - **URL**: https://apify.com/stealth\_mode/jobteaser-jobs-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results 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 Search Scraper: Extract Job Listings at Scale --- ### What Is JobTeaser.com? JobTeaser is a leading European student and graduate job platform, partnering with hundreds of universities to connect young talent with employers. It aggregates internships, apprenticeships, and entry-level roles across industries and countries. Manually collecting listings from its search pages is impractical at scale — the **JobTeaser Jobs Search Scraper** automates extraction from paginated search results, delivering clean, structured records ready for analysis. --- ### Overview The **JobTeaser Scraper** targets job search listing pages (e.g., `/en/job-offers?page=2`) and extracts key metadata for each result. It is suited for: - **University career centers** monitoring employer activity on the platform - **HR analysts** tracking entry-level hiring trends across Europe - **Aggregator developers** feeding graduate job data into custom platforms - **Researchers** studying student recruitment patterns --- ### Input Format ```json { "urls": ["https://www.jobteaser.com/en/job-offers?page=2"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | URLs of JobTeaser job search/listing pages to scrape. Add one per line or use bulk edit. Example: `https://www.jobteaser.com/en/job-offers?page=2` | | `max_items_per_url` | `integer` | Maximum number of job records to collect per URL. Default: `20` | | `ignore_url_failures` | `boolean` | If `true`, skips failed URLs instead of halting the run. Recommended for bulk jobs. Default: `true` | > **Tip:** To scrape multiple pages, add each paginated URL separately (e.g., `?page=1`, `?page=2`, ...). You can also filter by category or location in the URL query string before scraping. *** ### Output Format **Sample output** ```json { "activation_time": "2026-05-18T11:02:12.000Z", "candidacy_type": "EXTERNAL", "company": { "id": "3beb3dba-36ea-4639-baf4-b5118047a0c5", "logo_url": "https://d1guu6n8gz71j.cloudfront.net/system/asset/logos/1609/logo.png?1599645103", "name": "ORANO" }, "contract": { "duration_max": 24, "duration_min": 19, "type": "alternating" }, "created_by_student_or_alumni": false, "exclusive": false, "id": "b9d10ae7-3a3e-4868-86c0-a7a8a01b912b", "legacy_partner_school_ids": [ "ceedc5b8-2d88-4266-b4a5-663a0f84e7d0", "aebb87a4-8f61-4034-8d0f-a03e91590c19", "8aede46b-d4c1-4490-bfea-7747d7d5bc34", "89b75694-7f3b-4ab8-bac0-f5428533994b", "7acf3fe4-961b-45d5-b357-ede9f6587c50", "33b78c62-60f0-4c04-a508-323fdf2c97cf", "e7e5e31f-853a-4027-95fe-23aef540daec", "4ae912a2-f717-4083-870a-de269ea65351", "eefcb1d4-8bf4-4325-ae61-e99e33d52ae5", "ad6206e3-ea8d-4061-bdeb-e14efb87f45f", "b6c99a77-2656-4e69-8611-e58540cab773", "c6487e7b-6934-4b1a-9d8a-b5652f2385e8", "bfc36389-e3b2-47f3-9e24-ae76ace29280", "9f6705ec-cfbb-491a-8d10-bfed503c88c6", "43ef7be6-23ac-459c-8d3f-7ca402b6767f", "5f1f1044-6228-4cdc-a28d-56d7615fcaad", "5e5fc2bc-4362-4a15-9e98-e7b8a40f7b77", "ae5a48d0-38f2-4b92-b769-5866589b0103", "d07b5dbe-5110-46ad-b1cd-1879cf53de3b", "31cb4942-90d6-4043-9d24-e52ee5d9be54", "4a629d7e-b84a-4f2f-9ac4-daaa5b75e53a", "d5fe2f82-dfd1-4d34-8df8-4000be07a024", "79afd4cd-a464-421d-b194-93098faa7b40", "a9d538de-90e7-4bed-bbee-faa4d3d975c4", "4418c51a-2d26-428d-9ed9-198e209ce64a", "7d7e920c-1225-4f4c-bf17-d41c642c5867", "d8ffdf55-6301-4994-b6d4-6d66679e2417", "61af465e-6506-474a-af97-e84043db20d9", "7a701543-2d0a-48a5-a0e6-6c618aa45e71", "aaafb7cb-d239-4a6b-ab0b-383bea8e6c30", "a91557c4-1167-4d65-824e-bb86601cd911", "2dbbf211-16f4-4b0d-840a-38de5fc9c5d8", "817c0ec3-0c95-47de-8c02-006783dea971", "33982cd7-41de-4e9d-a6ae-e5f1c5e3dfa9", "44f925db-3071-41f3-807f-69fb8835079a", "5f830c21-d77c-4560-8c62-d1a2e7619d19", "40c8edb5-614b-4bf5-81d0-25495ef50592", "f5e0c2a9-9510-4c6f-aedc-3303954e78b3", "9fa6462a-2a7f-43f3-819f-7854d163c5e6", "4da3e6f4-d2f6-4abf-a865-fb1c7dc9f3cb", "ddcce403-e226-494f-9700-62da687c9396", "cdacc0e2-31ba-4b20-b62e-604bcc8a29ad", "18b4311a-442d-4696-b2b7-2837f64dc8ad", "d0f8b960-0105-41a6-91e0-03b39f166173", "8ec90aec-1a30-45ca-b98f-65571aacdf7f", "b4197c5f-10a8-4649-9b3d-d7cad1f178d6", "a326c99f-9034-48a6-8e6b-882f5d5072a1" ], "location": { "city": "Valognes", "country": "France", "formatted_address": "Valognes,Normandie,France", "place_id": "ChIJyznl_SiDDEgREkyRDZbvKEU", "state": "Normandy", "sub_state": "Manche", "latitude": 49.5089073, "longitude": -1.4692929 }, "locations": [ { "city": "Valognes", "country": "France", "formatted_address": "Valognes,Normandie,France", "place_id": "ChIJyznl_SiDDEgREkyRDZbvKEU", "state": "Normandy", "sub_state": "Manche", "latitude": 49.5089073, "longitude": -1.4692929 } ], "position": 1, "premium": false, "private_offer": false, "publication_type": { "name": "premium_credit", "score": 2 }, "search_index": "job_ads_search_en", "slug": "b9d10ae7-3a3e-4868-86c0-a7a8a01b912b-orano-controleur-de-gestion-f-h", "start_period": "2026_09", "title": "Contrôleur de Gestion F/H" } ``` Each job listing returns up to 18 structured fields: #### Identification | Field | Meaning | |---|---| | `ID` | Unique internal JobTeaser identifier for the listing | | `Slug` | URL-friendly string identifier for the job | | `Title` | Job title as displayed in search results | | `Position` | Standardized position/role category | | `Search Index` | Internal ranking or indexing value used by the platform | #### Company & Location | Field | Meaning | |---|---| | `Company` | Employer name and associated metadata | | `Location` | Primary location of the role | | `Locations` | Full list of locations (for multi-location postings) | #### Contract & Timing | Field | Meaning | |---|---| | `Contract` | Contract type (e.g., internship, full-time, apprenticeship) | | `Start Period` | Expected start period (e.g., "September 2025", "ASAP") | | `Activation Time` | Timestamp when the listing became active on the platform | #### Listing Type & Flags | Field | Meaning | |---|---| | `Publication Type` | How the offer was published (e.g., standard, sponsored) | | `Candidacy Type` | Application flow type (e.g., direct, redirected) | | `Exclusive` | Whether the listing is exclusive to JobTeaser partner schools | | `Premium` | Whether the listing has premium/paid placement | | `Private Offer` | Whether the listing is restricted to specific school networks | | `Created By Student Or Alumni` | Flags offers posted by student/alumni organizations | | `Legacy Partner School IDs` | IDs of partner schools historically associated with the listing | *** ### How to Use 1. **Get search page URLs** — Browse JobTeaser job search with your desired filters (location, contract type, keyword). Copy the resulting URL. 2. **Add to `urls`** — Paste one or more paginated search URLs into the input array. 3. **Set limits** — Use `max_items_per_url` to control volume per page (default: `20`, max recommended: `50`). 4. **Enable fault tolerance** — Keep `ignore_url_failures: true` for multi-URL runs. 5. **Export** — Download results as JSON, CSV, or Excel. **Common issues:** - Ensure URLs point to **search/listing pages**, not individual job detail pages. - If results seem incomplete, check whether the search URL requires authentication (some school-exclusive pages may be gated). *** ### Use Cases & Business Value - **University career offices:** Track which employers are actively recruiting from your school network - **Market research:** Analyze contract type distribution and hiring seasons across sectors - **Job aggregators:** Build or enrich graduate-focused job boards with live data - **Competitive intelligence:** Monitor employer presence and posting frequency on the platform *** ### Conclusion The **JobTeaser Jobs Search Scraper** turns paginated search results into structured, analysis-ready datasets. With 18 output fields covering job identity, company, location, contract, and listing flags, it provides a comprehensive view of graduate recruitment activity on one of Europe's leading student job platforms. Configure your search URLs, run the scraper, and export instantly. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.jobteaser.com/en/job-offers?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.jobteaser.com/en/job-offers?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/jobteaser-jobs-search-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 = { "urls": ["https://www.jobteaser.com/en/job-offers?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/jobteaser-jobs-search-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 '{ "urls": [ "https://www.jobteaser.com/en/job-offers?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/jobteaser-jobs-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/jobteaser-jobs-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobteaser Jobs Search Scraper", "description": "Scrape structured job listing data from JobTeaser.com search pages. Collect titles, locations, contracts, company info, and 18+ fields per listing — perfect for career researchers, university partnerships, and talent market analysts.", "version": "0.0", "x-build-id": "td64MNO33nHREfnGZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~jobteaser-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-jobteaser-jobs-search-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/stealth_mode~jobteaser-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-jobteaser-jobs-search-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/stealth_mode~jobteaser-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-jobteaser-jobs-search-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", "properties": { "urls": { "title": "URLs of the Jobs list urls to scrape", "type": "array", "description": "Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```