APEC Jobs Scraper

Extract job listings from APEC.fr for French executive, manager, specialist, and professional hiring research. Collect structured job data including titles, companies, locations, salaries, full descriptions, application contacts, skills, dates, and source metadata for analysis, monitoring, and recruitment workflows.

Features

• Complete job records - Collect job title, company, location, salary, publication dates, application links, and contact fields.
• Full description coverage - Includes job mission text, profile requirements, and company presentation when available.
• Skill and requirement data - Captures published skill labels and related detail fields for matching and analysis.
• Flexible search controls - Search by keyword, location, or a direct APEC search URL.
• Pagination support - Use results_wanted and max_pages to control collection size.
• Clean output - Empty values are removed and duplicate offers are skipped by offer reference.

Use Cases

Job Market Intelligence

Track hiring demand across French regions, sectors, and job functions. Build datasets for salary benchmarking, role trend analysis, and recurring market reports.

Recruitment Research

Collect detailed job descriptions, required skills, application links, and employer names for sourcing strategy. Use the output to compare competing offers and understand current employer expectations.

Salary and Demand Analysis

Analyze salary ranges, publication dates, job locations, and contract type identifiers across search terms. Export the dataset to BI tools or spreadsheets for dashboards and internal reporting.

Lead and Opportunity Monitoring

Monitor new openings for specific keywords, cities, regions, or job categories. Connect results to alerts, enrichment workflows, or CRM pipelines.

---

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	Prefilled APEC search URL	Direct APEC search URL. Explicit keyword and location inputs override matching URL filters.
keyword	String	No	"ingenieur"	Job title, skill, or keyword to search.
location	String	No	None	City or region name, such as Paris or Lyon.
results_wanted	Integer	No	20	Maximum number of job records to collect.
max_pages	Integer	No	2	Maximum number of search result pages to process.
proxyConfiguration	Object	No	{ "useApifyProxy": false }	Optional proxy settings.

---

Output Data

Each dataset item can contain:

Field	Type	Description
id	String	Unique job identifier.
numeroOffre	String	APEC job offer reference.
title	String	Job title.
company	String	Employer or advertiser name.
location	String	Published job location text.
salary	String	Salary text as shown by APEC.
salary_minimum	Number	Minimum salary value when available.
salary_maximum	Number	Maximum salary value when available.
published_at	String	Main publication date.
first_published_at	String	First publication date.
last_published_at	String	Latest publication date.
contract_type_id	Number	Contract type identifier.
sector_activity_id	Number	Sector activity identifier.
function_id	Number	Job function identifier.
experience_level_id	Number	Experience level identifier.
description_html	String	Full formatted job, profile, and company description.
description_text	String	Clean plain-text description.
applyLink	String	Application URL.
application_email	String	Application email when published.
reference_client_offre	String	Employer reference code.
address_street	String	Street address when available.
address_postal_code	String	Postal code when available.
address_city	String	City from the detailed offer address.
address_country_id	Number	Country identifier from the detailed offer address.
location_labels	Array	Flattened published location labels.
location_ids	Array	Flattened published location identifiers.
audit_created_at	String	Offer creation timestamp when available.
audit_modified_at	String	Offer modification timestamp when available.
latitude	Number or String	Latitude when available.
longitude	Number or String	Longitude when available.
skills	Array	Published skill labels.
url	String	APEC job detail URL.
source	String	Source label for the record.
api_listing	Object	Non-empty search listing metadata.
api_detail	Object	Non-empty offer metadata with raw skills, descriptions, locations, address, and audit blocks removed.
fetched_at	String	Extraction timestamp in UTC.

---

Usage Examples

Basic Search

Collect 20 engineering-related jobs:

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

City Search

Collect project management jobs in Paris:

{
  "keyword": "chef de projet",
  "location": "Paris",
  "results_wanted": 30,
  "max_pages": 3
}

User Input Priority

Use a prepared URL while overriding its keyword or location filters:

{
  "startUrl": "https://www.apec.fr/candidat/recherche-emploi.html/emploi?motsCles=data",
  "keyword": "marketing",
  "location": "Paris",
  "results_wanted": 20,
  "max_pages": 2
}

Direct Search URL

Use a prepared APEC search URL:

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

---

Sample Output

{
  "id": "179121351W",
  "numeroOffre": "179121351W",
  "title": "Analyste Financier F/H",
  "company": "CABINET VICTOIRE",
  "location": "Paris 03 - 75",
  "salary": "38 - 42 k€ brut annuel",
  "salary_minimum": 38,
  "salary_maximum": 42,
  "published_at": "2026-07-15T10:41:18.000+0000",
  "contract_type_id": 101888,
  "description_text": "Vous êtes diplômé(e) d’une Grande École de commerce...",
  "applyLink": "https://www.cabinet-victoire.fr/offre/analyste-financier-h-f-asscfo/",
  "application_email": "cv@cabinet-victoire.fr",
  "reference_client_offre": "ASSCFO",
  "skills": ["Autonomie", "Curiosité", "Finance", "Gestion de projet"],
  "url": "https://www.apec.fr/candidat/recherche-emploi.html/emploi/detail-offre/179121351W",
  "source": "api",
  "fetched_at": "2026-07-15T11:10:00.000Z"
}

---

Tips for Best Results

Start Focused

• Use specific keywords such as data engineer, responsable marketing, or chef de projet.
• Add location when you need regional data.

Tune Collection Size

• Keep results_wanted at 20 for quick test runs.
• Increase max_pages when collecting larger datasets.

Keep Runs Comparable

• Use the same keyword and location filters for recurring reports.
• Export results in the same format when building dashboards.

Proxy Configuration

Use the default proxy setting first:

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

Enable proxy settings only if your run environment requires them.

---

Integrations

Connect your data with:

• Google Sheets - Review and share job datasets.
• Airtable - Build searchable recruiting databases.
• Make - Automate notifications and enrichment.
• Zapier - Trigger workflows from new records.
• Webhooks - Send output to your own systems.

Export Formats

• JSON - Best for development workflows.
• CSV - Best for spreadsheet analysis.
• Excel - Best for reporting.
• XML - Best for system interchange.

---

Frequently Asked Questions

Does this scraper collect full job descriptions?

Yes. It collects the full published job description, profile requirements, and company presentation when those fields are available.

How are duplicates handled?

Duplicate offers are skipped by APEC offer reference, so repeated listings do not create repeated dataset records.

Why are some fields missing from a record?

Some employers do not publish every field. Empty values are removed to keep the dataset cleaner.

Can I use an APEC search URL?

Yes. Set startUrl to a direct APEC search URL when you already have filters prepared on the website.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• 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.