eFinancialCareers Jobs Scraper

Fast, production-ready Apify actor for scraping job listings from eFinancialCareers. Built with an API-first architecture for maximum speed and reliability.

🚀 Features

• ⚡ 10-20x Faster - Uses eFinancialCareers' JSON API instead of slow HTML crawling
• 🎯 Accurate Data - Extracts structured data from API and JSON-LD
• 💪 Production-Ready - Robust error handling, deduplication, and retry logic
• 🕵️ Stealthy - Mimics browser behavior with realistic headers and delays
• 📊 Complete Data - Optional full job descriptions from detail pages
• 🔧 Flexible - Search by keyword, location, or both

📋 Output Fields

Each job listing contains:

Field	Type	Description
job_id	string	Unique job identifier
title	string	Job title
company	string	Company name
location	string	Job location (city, state, country)
job_type	string	Employment type (Full time, Contract, etc.)
salary	string	Salary information (if available)
date_posted	string	When the job was posted
description_html	string	Full job description (HTML) - if collectFullDescription enabled
description_text	string	Job description (plain text)
url	string	Link to job posting

🎮 Input Configuration

Basic Parameters

• keyword (string) - Search term (e.g., "software engineer", "analyst", "trader")
• location (string) - Location filter (e.g., "New York", "London", "Singapore")
• results_wanted (integer, default: 100) - Maximum number of jobs to collect
• max_pages (integer, default: 10) - Safety limit on API pages to fetch

Advanced Options

• collectFullDescription (boolean, default: true) - Fetch full HTML descriptions from detail pages
  • true - Slower, complete job descriptions with formatting
  • false - Faster, API-only data with truncated descriptions
• apiPageSize (integer, default: 100, max: 100) - Jobs per API request
• proxyConfiguration (object) - Apify Proxy settings (datacenter recommended)

📖 Usage Examples

Example 1: Quick Search (API Only)

{
  "keyword": "financial analyst",
  "location": "New York",
  "results_wanted": 50,
  "collectFullDescription": false
}

⚡ Speed: ~30 seconds for 50 jobs

Example 2: Complete Data (with Descriptions)

{
  "keyword": "software engineer",
  "location": "London",
  "results_wanted": 100,
  "collectFullDescription": true
}

⚡ Speed: ~2-3 minutes for 100 jobs

Example 3: All Jobs (No Filters)

{
  "keyword": "",
  "location": "",
  "results_wanted": 200,
  "max_pages": 5
}

🏗️ Architecture

API-First Approach

This scraper uses a hybrid strategy for optimal speed and data quality:

1. Phase 1: JSON API - Fetch job listings in bulk (100 per request)

   • Endpoint: https://job-search-ui.efinancialcareers.com/v1/efc/jobs/search
   • Returns: job_id, title, company, location, salary, date, truncated description

2. Phase 2: Detail Pages (Optional) - Fetch full descriptions

   • Extract from JSON-LD structured data (most reliable)
   • Fallback to HTML parsing if needed
   • Merge with API data

Data Quality

• JSON API: Primary source for all core fields (company, location, salary, etc.)
• JSON-LD: Best source for full job descriptions
• HTML Parsing: Failsafe fallback for edge cases
• Deduplication: Automatic by job_id

⚙️ How It Works

┌─────────────┐
│  User Input │
└──────┬──────┘
       │
       ▼
┌─────────────────────┐
│  Call JSON API      │ ◄── Fast: 100 jobs/request
│  (Pagination Loop)  │
└──────┬──────────────┘
       │
       ▼
┌─────────────────────┐
│  Parse API Response │
│  + Deduplicate      │
└──────┬──────────────┘
       │
       ▼
   ┌───────────────────┐
   │ Full Description? │
   └────┬──────────┬───┘
        │ No       │ Yes
        │          │
        ▼          ▼
   ┌─────┐   ┌──────────────┐
   │Save │   │Fetch Details │
   │ API │   │(JSON-LD/HTML)│
   │Data │   └──────┬───────┘
   └─────┘          │
                    ▼
               ┌─────────┐
               │  Merge  │
               │  & Save │
               └─────────┘

🔍 Performance Benchmarks

Jobs	collectFullDescription	Time	Speed
50	false	~30s	100 jobs/min
50	true	~1 min	50 jobs/min
100	false	~1 min	100 jobs/min
100	true	~2-3 min	35-50 jobs/min

Benchmarks using Apify datacenter proxies

🛠️ Development

Local Testing

# Install dependencies
npm install

# Run locally
npm start

Deploy to Apify

# Login to Apify CLI
apify login

# Deploy
apify push

🤝 Support

For issues, questions, or feature requests, please open an issue on GitHub.

📄 License

This project is licensed under the Apache License 2.0.

🏷️ Keywords

eFinancialCareers, jobs scraper, job listings, finance jobs, banking jobs, Apify actor, web scraping, job board, recruitment