APEC Jobs Scraper

Extract and collect executive and managerial job listings from APEC.fr with reliable, structured output. Gather job titles, companies, locations, salary details, full descriptions, and enriched listing metadata for research, monitoring, and analytics workflows.

Features

• Comprehensive job records — Capture key fields such as title, company, location, salary, publish date, and apply link.
• Description-ready output — Includes both description_html and cleaned description_text when available.
• Flexible search controls — Run with a direct APEC search URL or with keyword, location, and department filters.
• Paginated collection — Collect the amount of data you need with results_wanted and max_pages.
• Enriched metadata fields — Adds non-empty listing/detail metadata in api_listing and api_detail.
• Lean detail payload — Excludes oversized competences arrays from dataset output.

Use Cases

Job Market Intelligence

Track hiring trends for executive and specialist roles across regions and sectors. Build recurring snapshots for trend analysis and reporting.

Recruitment Research

Create structured datasets of open roles, salary signals, and company activity. Support sourcing strategy and market benchmarking.

Salary and Demand Analysis

Compare salary ranges and role demand across cities and departments. Use normalized records for dashboards and BI tools.

Lead and Opportunity Monitoring

Monitor new openings for specific keywords, locations, or departments. Trigger downstream workflows when matching roles appear.

---

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	—	Direct APEC search URL. When provided, URL filters are prioritized.
keyword	String	No	"ingenieur"	Job title or skill keywords to search.
location	String	No	""	City or region name (for example, Paris or Lyon).
department	String	No	""	French department code (for example, 75, 69, 13).
results_wanted	Integer	No	20	Maximum number of jobs to collect.
max_pages	Integer	No	2	Maximum number of result pages to process.
proxyConfiguration	Object	No	{ "useApifyProxy": false }	Optional proxy settings for your environment.

---

Output Data

Each dataset item contains:

Field	Type	Description
id	String	Unique job identifier.
numeroOffre	String	Job offer reference from APEC.
title	String	Job title.
company	String	Company name.
location	String	Job location text.
salary	String	Salary text when available.
published_at	String	Job publication date/time.
description_html	String or null	Rich HTML description when provided.
description_text	String or null	Cleaned plain-text description.
applyLink	String	Application URL.
url	String	Job detail URL.
source	String	Data source label.
api_listing	Object	Non-empty listing metadata fields.
api_detail	Object	Non-empty detail metadata fields (without competences).
fetched_at	String	Extraction timestamp (UTC ISO format).

---

Usage Examples

Basic Search

{
  "keyword": "ingenieur",
  "location": "Paris",
  "results_wanted": 20,
  "max_pages": 2
}

Department-Focused Collection

{
  "keyword": "chef de projet",
  "department": "69",
  "results_wanted": 50,
  "max_pages": 4
}

Direct Search URL

{
  "startUrl": "https://www.apec.fr/candidat/recherche-emploi.html/emploi?motsCles=data",
  "results_wanted": 30,
  "max_pages": 3
}

---

Sample Output

{
  "id": "178206207W",
  "numeroOffre": "178206207W",
  "title": "Directeur de projet Hydraulique urbaine confirmé F/H",
  "company": "L'USINE NOUVELLE",
  "location": "Paris 01 - 75",
  "salary": "A négocier",
  "published_at": "2026-02-20T05:17:10.000+0000",
  "description_html": "<p>...job description...</p>",
  "description_text": "...job description...",
  "applyLink": "https://example.com/apply",
  "url": "https://www.apec.fr/candidat/recherche-emploi.html/emploi/detail-offre/178206207W",
  "source": "api",
  "api_listing": {
    "numeroOffre": "178206207W",
    "intitule": "Directeur de projet Hydraulique urbaine confirmé F/H",
    "lieuTexte": "Paris 01 - 75"
  },
  "api_detail": {
    "intitule": "Directeur de projet Hydraulique urbaine confirmé F/H",
    "salaireTexte": "A négocier",
    "texteHtml": "<p>...detail description...</p>"
  },
  "fetched_at": "2026-02-20T05:19:12.031Z"
}

---

Tips for Best Results

Start with Focused Queries

• Use precise keywords to improve result relevance.
• Narrow by location or department for targeted datasets.

Scale Collection Safely

• Start with smaller results_wanted values for test runs.
• Increase max_pages progressively for larger pulls.

Keep Data Consistent

• Use one query strategy per run for cleaner comparisons.
• Schedule recurring runs with the same filters for trend tracking.

Proxy Configuration

{
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Enable proxy only when your environment requires it.

---

Integrations

Connect your dataset with:

• Google Sheets — Share and review job data in spreadsheets.
• Airtable — Build searchable job databases for teams.
• Make — Automate enrichment and notifications.
• Zapier — Trigger actions when new jobs are collected.
• Webhooks — Send output to your own services.

Export Formats

• JSON — Best for APIs and development workflows.
• CSV — Best for spreadsheet analysis.
• Excel — Best for business reporting.
• XML — Best for system interoperability.

---

Frequently Asked Questions

How many jobs can I collect in one run?

You control volume with results_wanted and max_pages. Increase both for larger datasets.

Why is a field sometimes empty?

Some listings do not publish every field. The actor keeps those fields as null when source data is unavailable.

Are job descriptions included?

Yes. The dataset includes description_html and description_text when available.

Is competences included in the dataset?

No. competences is intentionally excluded from output to keep dataset size manageable.

Can I use a direct APEC search URL?

Yes. Set startUrl to collect jobs from a pre-filtered results page.

---

Support

For issues or feature requests, use the Apify Console issue and support channels.

Resources

• Apify Documentation
• Apify API Reference
• Apify Scheduling

---

Legal Notice

This actor is intended for lawful data collection and analysis. You are responsible for complying with applicable laws, regulations, and website terms when using collected data.