# Welcome to the Jungle Jobs Scraper (`devilscrapes/welcome-to-the-jungle-jobs-scraper`) Actor

Search Welcome to the Jungle's FR/EU job board by keyword, country, contract type, and remote policy. One row per listing with title, company, location, contract type, salary, and remote status - pay only for results that land.

- **URL**: https://apify.com/devilscrapes/welcome-to-the-jungle-jobs-scraper.md
- **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community)
- **Categories:** Jobs
- **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

<p align="center">
  <img src=".actor/icon.svg" width="160" alt="Welcome to the Jungle Jobs Scraper icon" />
</p>

## Welcome to the Jungle Jobs Scraper

**$2.70 / 1 000 results** — pay only for results that land, no credit card to try.

### 🔥 What this scrapes

Welcome to the Jungle (welcometothejungle.com) is a FR/EU job board covering
thousands of live listings across tech, ops, sales, and more. This Actor
queries the same search index the site itself uses to render results, and
returns one clean row per listing — title, company, location, contract
type, remote policy, and salary, when the recruiter publishes one.

### ✨ Features

- Free-text keyword search, or leave it blank to browse everything live.
- Filter by country, contract type, and remote-work policy — combine all
  three in a single query.
- One row per listing: title, company, offices, contract type, remote
  policy, salary range, experience level, sectors, and more.
- 🛡️ We rotate browser fingerprints (curl-cffi impersonation — Chrome and
  Firefox) so the target sees a real browser, not a Python script.
- 🔁 We retry with exponential backoff on `408 / 429 / 5xx` and honour
  `Retry-After`. Up to 5 attempts per page.
- 🧊 We keep the dataset clean — Pydantic-validated rows, ISO-8601
  timestamps, stable IDs.
- 💰 You pay only for results that land. No data → no charge (only the
  small `actor-start` warm-up fee).

### 🎯 Use cases

- **Recruiters and sourcers** benchmarking competing job postings by
  country, contract type, or remote policy.
- **Job seekers and career-tooling builders** who want structured listing
  data to filter and rank without manually paging the site.
- **Market researchers** tracking hiring trends — which sectors, roles,
  and remote policies are growing in the FR/EU market.

### ⚙️ How to use it

1. Click **Try for free** on the Apify Store page (or **Run** in Console).
2. Set a `query` (optional — leave blank to browse all listings), and
   optionally narrow by `country`, `contractType`, or `remote`.
3. Set `maxResults` — how many rows you want, up to 1,000 per search.
4. Run the Actor. Results stream into the default dataset as they're found.
5. Export the dataset as JSON, CSV, Excel, or connect it to your pipeline
   via the Apify API.

### 📥 Input

| Field | Type | Default | Description |
|---|---|---|---|
| `query` | string | `""` | Free-text search term; empty = browse-all |
| `country` | string | — | ISO alpha-2 country code, e.g. `FR`, `DE` |
| `contractType` | enum | — | `FULL_TIME`, `INTERNSHIP`, `APPRENTICESHIP`, `TEMPORARY`, `FREELANCE`, `VIE`, `PART_TIME`, `OTHER` |
| `remote` | enum | — | `partial`, `punctual`, `unknown`, `no`, `fulltime` |
| `maxResults` | integer | `200` | Max rows to return (1–1000) |
| `proxyConfiguration` | object | Apify Proxy | Standard Apify Proxy editor field |

```json
{
  "query": "python",
  "country": "FR",
  "contractType": "FULL_TIME",
  "remote": "partial",
  "maxResults": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

### 📤 Output

One dataset row per job listing:

| Field | Type | Description |
|---|---|---|
| `objectId`, `title`, `slug` | string | Listing identity |
| `jobUrl` | string | Full listing URL |
| `companyName`, `companySlug` | string | Hiring company |
| `offices` | array | City/state/country per office |
| `contractType`, `contractTypeLabel` | string | null | Contract type + label |
| `remote` | string | null | Remote-work policy |
| `publishedAt` | string | null | ISO-8601 publish timestamp |
| `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` | number/string | null | Salary range, when published |
| `sectors`, `profession`, `department` | array/string | null | Role classification |

```json
{
  "objectId": "4821093",
  "title": "Lead Frontend Developer",
  "slug": "lead-frontend-developer_paris",
  "jobUrl": "https://www.welcometothejungle.com/fr/companies/pickyourskills/jobs/lead-frontend-developer_paris",
  "companyName": "PickYourSkills",
  "offices": [{"city": "Paris", "country": "France", "country_code": "FR"}],
  "contractType": "FULL_TIME",
  "contractTypeLabel": "CDI",
  "remote": "partial",
  "publishedAt": "2026-09-10T08:00:00.000+02:00",
  "salaryMin": 45000,
  "salaryMax": 60000,
  "salaryCurrency": "EUR",
  "promoted": false
}
```

### 💰 Pricing

Pay-per-event — you're charged only for what the run actually does.

| Event | Price | Trigger |
|---|---|---|
| Actor start | $0.20 | Once per run |
| Result emitted | $0.0025 | Once per job listing row |

At 1,000 results: `$0.20 + 1000 × $0.0025 = $2.70`. A zero-match search
still succeeds — you're charged only the small warm-up fee.

### 🚧 Limitations

- The underlying search index caps any single query+filter combination at
  1,000 total hits. Narrow with `query`, `country`, `contractType`, or
  `remote` to reach listings beyond that ceiling.
- Full job-page HTML (benefits copy, application forms) isn't included —
  the index already carries everything customer-relevant to filtering and
  ranking listings.
- Company-profile enrichment (reviews, culture pages) is out of scope for
  this Actor.

### ❓ FAQ

**Does this need a login?** No — listings are public.

**Why did my search return zero rows?** Some query + filter combinations
genuinely have no matches. The run still succeeds; check the status
message for what was searched.

**Can I filter by multiple countries at once?** Not in this version — one
country per run. Run the Actor once per country if you need several.

**How fresh is the data?** As fresh as the source index — there's no
caching layer between this Actor and the live search.

### 🙋 Your feedback

Found a bug or have a feature request? Message us via the Apify Store
**Issues** tab or the DevilScrapes contact page —
https://apify.com/DevilScrapes. We read every report.

# Changelog

This Actor's version history is a separate document: https://apify.com/devilscrapes/welcome-to-the-jungle-jobs-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

Free-text search term, e.g. "python" or "nurse". Leave blank to browse all listings.

## `country` (type: `string`):

ISO alpha-2 country code to narrow results, e.g. "FR", "DE", "ES". Leave blank for all countries.

## `contractType` (type: `string`):

Filter by contract type. Leave blank for all contract types.

## `remote` (type: `string`):

Filter by remote-work policy. Leave blank for all remote policies.

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

Maximum number of job listings to return. Capped at Algolia's 1,000-hit pagination ceiling.

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

Apify Proxy configuration. The only confirmed anti-bot check on this target is a Referer/Origin header pair, which we satisfy regardless of exit IP - switch to RESIDENTIAL here if you see blocks at scale.

## Actor input object example

```json
{
  "query": "python",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

All dataset items as JSON.

## `datasetItemsCsv` (type: `string`):

Same data exported to CSV.

## `datasetView` (type: `string`):

Open the run dataset in the Console.

# 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 = {
    "query": "python",
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/welcome-to-the-jungle-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 = {
    "query": "python",
    "maxResults": 200,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/welcome-to-the-jungle-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 '{
  "query": "python",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call devilscrapes/welcome-to-the-jungle-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,devilscrapes/welcome-to-the-jungle-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/IGxMTF21q54DCGnzM/builds/95Zbhyb5aE5P34DV0/openapi.json