# APEC Jobs Scraper (`khadinakbar/apec-jobs-scraper`) Actor Scrape APEC.fr French executive (cadre) job postings — title, company, salary, location, contract type, remote work, apply URL. HTTP-only, no login, MCP-ready. - **URL**: https://apify.com/khadinakbar/apec-jobs-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Jobs, Lead generation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 job scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## APEC Jobs Scraper Scrape **APEC.fr** — France's largest executive (*cadre*) job board — with one HTTP call per page. No login, no cookies, no DataDome challenge, no Playwright. Returns rich per-offer fields: title, company, salary range (parsed to numeric min/max), location, lat/long, contract type, remote-work policy, posted date, and the public apply URL. 110K+ active offers, MCP-ready. ### What you get | Field | Type | Description | |---|---|---| | `jobId` | string | APEC numeric offer ID | | `offerNumber` | string | APEC public number (used in URL) | | `title` | string | Job title (French) | | `company` | string \| null | Hiring company; null when offer is confidential | | `isConfidential` | boolean | True when APEC hides the company | | `location` | string \| null | City + department code (e.g. `Paris 13 - 75`) | | `latitude`, `longitude` | number \| null | Geo coordinates | | `salaryText` | string \| null | Salary as posted by employer (French) | | `salaryMin`, `salaryMax` | number \| null | Parsed annual gross salary (EUR/year) | | `contractType` | string \| null | `CDI`, `CDD`, `FREELANCE`, `STAGE`, `ALTERNANCE`, `OTHER` | | `contractDurationMonths` | number \| null | Duration for fixed-term contracts (0 for CDI) | | `remoteWork` | string \| null | `FULL_REMOTE`, `HYBRID`, `OCCASIONAL`, `NONE`, `UNKNOWN` | | `descriptionExcerpt` | string \| null | First ~300 chars of the job description | | `publishedAt` | string \| null | ISO 8601 publication date | | `validatedAt` | string \| null | ISO 8601 validation date | | `lowApplicationCount` | boolean \| null | APEC flag for low-competition offers | | `sectorCode`, `sectorParentCode` | number \| null | APEC sector IDs | | `url` | string | Public APEC URL | ### When to use - Recruiters sourcing French *cadre* candidates by salary band, location, or contract type. - Salary benchmarking for French executive roles (parsed `salaryMin`/`salaryMax`). - Market research on the French executive job market (sector, location, remote-work distribution). - Building French job-board aggregators or salary dashboards. - AI agents (Claude, GPT, Gemini) answering "what executive jobs are open in Paris this week?" via MCP. **When NOT to use:** for full job descriptions beyond the ~300-char excerpt — APEC walls the detail page with DataDome. The excerpt is enough for triage; use the public `url` field to drive a manual browser visit when full text is needed. ### Pricing | Event | Price | |---|---| | Actor start | **$0.00005** per run (per GB allocated RAM) | | Job scraped | **$0.005** per offer pushed to dataset | 50 jobs ≈ $0.25; 1000 jobs ≈ $5. The actor enforces a hard `maxResults` cap so cost is bounded up front. ### Quick start #### Apify Console 1. Open the actor and click **Try for free**. 2. Set `searchQuery` to e.g. `data scientist` (or leave empty to browse all offers). 3. Set `maxResults`, `postedWithinDays`, `salaryMin`, `contractTypes`, `remoteWork`, `experienceLevel` as needed. 4. Click **Start**. #### Apify API (Node.js) ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('khadinakbar/apec-jobs-scraper').call({ searchQuery: 'développeur python', maxResults: 100, sortBy: 'date_desc', postedWithinDays: 7, salaryMin: 50000, contractTypes: ['CDI'], remoteWork: ['FULL_REMOTE', 'HYBRID'], }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ```` #### Apify API (Python) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("khadinakbar/apec-jobs-scraper").call(run_input={ "searchQuery": "directeur financier", "maxResults": 200, "sortBy": "date_desc", "salaryMin": 80000, "contractTypes": ["CDI"], }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["title"], "—", item["company"], "—", item["salaryText"]) ``` #### MCP (Claude / GPT / agent) Available at `https://mcp.apify.com?tools=khadinakbar/apec-jobs-scraper`. Tool name: `apify--khadinakbar--apec-jobs-scraper`. Pass the same `searchQuery`, `maxResults`, etc. inputs as above. ### Input | Field | Type | Default | Notes | |---|---|---|---| | `searchQuery` | string | `data scientist` | French keyword(s). Empty = all 110K+ offers. | | `maxResults` | int | `50` | Hard cap on items pushed (1–1000). | | `sortBy` | enum | `date_desc` | `relevance`, `date_desc`, `date_asc`. | | `postedWithinDays` | int | — | Filter by recency (1, 7, 14, 30, 90…). | | `salaryMin` | int | — | Minimum annual gross salary in EUR. | | `salaryMax` | int | — | Maximum annual gross salary in EUR. | | `contractTypes` | array | — | `CDI`, `CDD`, `FREELANCE`, `STAGE`, `ALTERNANCE`. | | `remoteWork` | array | — | `FULL_REMOTE`, `HYBRID`, `OCCASIONAL`, `NONE`. | | `experienceLevel` | array | — | `JUNIOR`, `MID`, `SENIOR`, `EXEC`. | | `proxy` | proxy | Apify auto | Datacenter is sufficient (no anti-bot). | ### How it works The actor calls APEC's internal search webservice (`POST /cms/webservices/rechercheOffre`) directly. This is the same endpoint the apec.fr SPA uses for its search page, but unlike the SPA's HTML pages it is **not** protected by DataDome — it returns clean JSON with a `totalCount` and a `resultats[]` array. Each result includes most useful fields already (title, salary text, geo, contract code, telework code, date). The actor: 1. Builds a `RechercheOffreCriteriaDto` payload from your input. 2. Maps human-readable contract/remote/experience names to APEC's internal Long IDs. 3. Pages through results with `pagination.startIndex` + `pagination.range=20` until `maxResults` or `totalCount` is reached. 4. Normalizes each result: parses French salary strings to numeric ranges, decodes contract/remote codes to enums, builds the public URL. 5. Charges per result via Apify PPE; respects a triple-guard counter so no charge fires beyond `maxResults`. ### FAQ **Why not the full description?** APEC's individual offer pages (`/candidat/recherche-emploi.html/emploi/detail-offre/{id}`) are gated by DataDome. The search-results endpoint already includes a ~300-char excerpt for each offer — usually enough for triage. Full descriptions would require a headless browser per offer (~$0.02 each in proxy + compute), inflating cost 4× for marginal data. **Is salary always present?** No. APEC employers can omit salary. When omitted, `salaryText`, `salaryMin`, and `salaryMax` are all `null`. When present, the parser handles `"45 - 49 k€ brut annuel"`, `"A partir de 40 k€"`, `"Jusqu'à 80 k€"`, and similar French phrasings. **Does APEC return all matching offers?** APEC's API exposes a `totalCount` field, but in practice paging beyond ~1000 results returns empty pages. For large queries, slice by `sortBy=date_desc` + `postedWithinDays` to fetch fresh offers, run on a schedule, and dedupe by `jobId`. **Is this legal?** APEC publishes its job offers publicly without a login wall. This actor reads only what's exposed by APEC's own public search endpoint, used by every visitor to apec.fr. Respect APEC's [terms of service](https://www.apec.fr/cms/legal/mentions-legales) and your local data-protection laws (RGPD / GDPR) when using the data. **Is there a rate limit?** APEC tolerates the request rate this actor uses (one page per ~1 second, default config). If you parallelize many runs, expect the API to throttle — set `maxResults` low and rely on the actor's built-in retry/backoff. ### Disclaimer This actor scrapes data from publicly accessible pages of apec.fr. It does not bypass authentication, login walls, or anti-scraping defenses. APEC.fr is a registered trademark of L'Association Pour l'Emploi des Cadres; this actor is not affiliated with or endorsed by APEC. Use the data responsibly and in accordance with applicable laws (RGPD / GDPR, APEC ToS). ### Related actors by the same author - [LinkedIn Jobs Scraper](https://apify.com/khadinakbar/linkedin-jobs-scraper) — salary + skills. - [StepStone Jobs Scraper](https://apify.com/khadinakbar/stepstone-jobs-scraper) — Germany. - [Indeed Job Scraper](https://apify.com/khadinakbar/indeed-job-scraper) — global. - [Monster Jobs Scraper](https://apify.com/khadinakbar/monster-jobs-scraper). - [Visa-Sponsored Jobs Scraper](https://apify.com/khadinakbar/visa-sponsored-jobs-scraper). - [Jobs Scraper](https://apify.com/khadinakbar/jobs-scraper) — Indeed + LinkedIn + Glassdoor unified. # Actor input Schema ## `searchQuery` (type: `string`): Free-text keyword(s) searched on APEC.fr (e.g., 'développeur', 'data scientist', 'directeur financier'). Searches title and description, French syntax. Leave empty to browse all 110K+ active offers. NOT a job ID or URL. ## `maxResults` (type: `integer`): Maximum number of job offers to return. Defaults to 50. APEC caps a single search at ~1000 results regardless of totalCount, so use sortBy + dateFilter to slice large queries. NOT items per page. ## `sortBy` (type: `string`): How to sort results. 'relevance' uses APEC's default scoring; 'date\_desc' returns newest first (best for monitoring); 'date\_asc' oldest first. Defaults to date\_desc. ## `postedWithinDays` (type: `integer`): Only return offers published within the last N days. Common values: 1, 7, 14, 30, 90. Leave empty for all (no date filter). Useful for daily monitoring jobs. ## `salaryMin` (type: `integer`): Filter offers with minimum annual gross salary in euros (e.g., 50000 = 50 k€). APEC stores salary as range; filter matches offers whose lower bound >= this value. Leave empty for no filter. ## `salaryMax` (type: `integer`): Filter offers with maximum annual gross salary in euros. Leave empty for no upper bound. Combine with salaryMin for a band (e.g., 40k–60k). ## `contractTypes` (type: `array`): Filter by contract type. CDI = permanent, CDD = fixed-term, FREELANCE = freelance/contractor, STAGE = internship, ALTERNANCE = apprenticeship. Leave empty for all types. ## `remoteWork` (type: `array`): Filter by remote-work policy. FULL\_REMOTE = 100% remote, HYBRID = partial remote, OCCASIONAL = occasional remote, NONE = on-site only. Leave empty for all. ## `experienceLevel` (type: `array`): Filter by required experience. JUNIOR = <1 year, MID = 1–7 years, SENIOR = 7+ years, EXEC = executive. Leave empty for all levels. ## `proxy` (type: `object`): Apify Proxy configuration. Default is auto datacenter (sufficient — APEC API has no anti-bot challenge). Override only if your account has special proxy needs. ## Actor input object example ```json { "searchQuery": "développeur python", "maxResults": 50, "sortBy": "date_desc", "proxy": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (type: `string`): JSON dataset with all scraped APEC job offers. ## `summary` (type: `string`): Stats + sample of the first 3 records. # 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 = { "searchQuery": "data scientist", "maxResults": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/apec-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "data scientist", "maxResults": 50, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/apec-jobs-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 '{ "searchQuery": "data scientist", "maxResults": 50 }' | apify call khadinakbar/apec-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/apec-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "APEC Jobs Scraper", "description": "Scrape APEC.fr French executive (cadre) job postings — title, company, salary, location, contract type, remote work, apply URL. HTTP-only, no login, MCP-ready.", "version": "0.1", "x-build-id": "MDbMmJ015raTujGab" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~apec-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-apec-jobs-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/khadinakbar~apec-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-apec-jobs-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/khadinakbar~apec-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-apec-jobs-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": { "searchQuery": { "title": "Search query (mots-clés)", "type": "string", "description": "Free-text keyword(s) searched on APEC.fr (e.g., 'développeur', 'data scientist', 'directeur financier'). Searches title and description, French syntax. Leave empty to browse all 110K+ active offers. NOT a job ID or URL." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of job offers to return. Defaults to 50. APEC caps a single search at ~1000 results regardless of totalCount, so use sortBy + dateFilter to slice large queries. NOT items per page.", "default": 50 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "date_desc", "date_asc" ], "type": "string", "description": "How to sort results. 'relevance' uses APEC's default scoring; 'date_desc' returns newest first (best for monitoring); 'date_asc' oldest first. Defaults to date_desc.", "default": "date_desc" }, "postedWithinDays": { "title": "Posted within N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only return offers published within the last N days. Common values: 1, 7, 14, 30, 90. Leave empty for all (no date filter). Useful for daily monitoring jobs." }, "salaryMin": { "title": "Minimum salary (EUR/year, gross)", "minimum": 0, "type": "integer", "description": "Filter offers with minimum annual gross salary in euros (e.g., 50000 = 50 k€). APEC stores salary as range; filter matches offers whose lower bound >= this value. Leave empty for no filter." }, "salaryMax": { "title": "Maximum salary (EUR/year, gross)", "minimum": 0, "type": "integer", "description": "Filter offers with maximum annual gross salary in euros. Leave empty for no upper bound. Combine with salaryMin for a band (e.g., 40k–60k)." }, "contractTypes": { "title": "Contract types", "uniqueItems": true, "type": "array", "description": "Filter by contract type. CDI = permanent, CDD = fixed-term, FREELANCE = freelance/contractor, STAGE = internship, ALTERNANCE = apprenticeship. Leave empty for all types.", "items": { "type": "string", "enum": [ "CDI", "CDD", "FREELANCE", "STAGE", "ALTERNANCE" ] } }, "remoteWork": { "title": "Remote work", "uniqueItems": true, "type": "array", "description": "Filter by remote-work policy. FULL_REMOTE = 100% remote, HYBRID = partial remote, OCCASIONAL = occasional remote, NONE = on-site only. Leave empty for all.", "items": { "type": "string", "enum": [ "FULL_REMOTE", "HYBRID", "OCCASIONAL", "NONE" ] } }, "experienceLevel": { "title": "Experience level", "uniqueItems": true, "type": "array", "description": "Filter by required experience. JUNIOR = <1 year, MID = 1–7 years, SENIOR = 7+ years, EXEC = executive. Leave empty for all levels.", "items": { "type": "string", "enum": [ "JUNIOR", "MID", "SENIOR", "EXEC" ] } }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Default is auto datacenter (sufficient — APEC API has no anti-bot challenge). Override only if your account has special proxy needs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```