MyJobMag Scraper 🚀

MyJobMag Scraper is a high-performance Apify Actor designed to crawl regional MyJobMag job boards and extract comprehensive job listings and detailed vacancy information.

By leveraging curl_cffi with Chrome impersonation, the scraper easily navigates anti-bot protections, while BeautifulSoup ensures fast and precise HTML parsing.

---

🌟 Features

• Multi-Regional Support: Seamlessly scrape across multiple country-specific MyJobMag domains.
• Smart Search Routing: Automatically switches between targeted search mode (when filters are provided) and latest listings mode.
• Advanced Filtering: Refine results using keywords, locations, job fields, and education levels.
• Deep Data Extraction: Pulls granular data, including company branding, employment types, salary ranges, and application links.
• Granular Controls: Optimize your budget and runtime by enforcing strict maxPages and maxResults limits.
• Proxy Integration: Fully compatible with Apify Proxy configurations to maintain high anonymity.

---

🌍 Supported Countries

The actor dynamically routes requests based on the selected country ISO code:

Code	Region	Base URL
NG	Nigeria	[https://www.myjobmag.com](https://www.myjobmag.com)
GH	Ghana	[https://www.myjobmagghana.com](https://www.myjobmagghana.com)
KE	Kenya	[https://www.myjobmag.co.ke](https://www.myjobmag.co.ke)
ZA	South Africa	[https://www.myjobmag.co.za](https://www.myjobmag.co.za)
UK	United Kingdom	[https://www.myjobmag.co.uk](https://www.myjobmag.co.uk)

---

📥 Input Settings

The actor accepts a JSON object with the following configuration properties:

Field	Type	Required	Default	Description
country	string	Yes	"NG"	Supported values: NG, GH, KE, ZA, UK.
keyword	string	No	""	Search keyword for job titles or skills.
location	string	No	""	Geographic location filter (e.g., "Lagos").
field	string	No	""	Job field or professional category.
education	string	No	""	Minimum education requirement filter.
maxPages	integer	Yes	5	Maximum number of listing pages to pagination through (Range: 1 - 100).
maxResults	integer	No	100	Maximum number of dataset items to save before stopping early.
proxyConfiguration	object	No	{"useApifyProxy": true}	Apify proxy settings to manage IP rotation.

---

📤 Output Structure

The scraper outputs structured data directly to your Apify Dataset. Below are the key fields extracted from each vacancy:

• Job Meta: title, listingTitle, pageHeader, summary
• Company Details: companyName, brandLogo (URL)
• Job Requirements: employmentType, educationRequired, experienceRequired
• Location & Category: location, jobField, salaryRange
• Source & Application: sourceUrl, applicationMethod (links or instructions), vacancyIndex
• Context: country

---

💡 How It Works & Developer Notes

📑 Multi-Vacancy Pages: Some job detail pages on MyJobMag bundle multiple job openings together. When this happens, the actor splits them into separate records and tracks them using the vacancyIndex field.

• Execution Logic: If any filter (keyword, location, field, or education) is provided, the scraper targets the MyJobMag search endpoint. If all are left blank, it defaults to capturing the fresher, latest job listings.
• Early Exit: The actor respects both page limits and results limits. Whichever threshold is hit first will safely terminate the run.
• Fail-safes: The country input is fully normalized. Passing an unsupported country code will safely fallback to NG.

---

🛠️ Example Input Configuration

{
  "country": "NG",
  "keyword": "software engineer",
  "location": "Lagos",
  "field": "IT",
  "education": "Bachelor",
  "maxPages": 5,
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}