Monster Job Scraper Welcome to the Monster Job Scraper! This Apify Actor scrapes job listings from Monster.com based on your search query and location. Whether you're hunting for entry-level tech jobs or researching market trends, this Actor delivers detailed job data in a clean, structured format. ## Features - Search jobs by keyword (e.g., "Software Engineer") and location (e.g., "San Francisco, CA"). - Customize search radius, page range, and jobs per page. - Option to scrape all available pages (up to 10) for maximum data. - Returns rich job details: titles, descriptions, salaries, company info, and more. ## How to Use 1. Set Up: Run this Actor on the Apify platform with your desired inputs. 2. Input: Provide a JSON object (see below) via the Apify Console or API. 3. Output: Get job listings in Apify’s Dataset, downloadable as JSON, CSV, or other formats. ## Input Data Format The Actor accepts a JSON object with the following fields. Required fields are marked with *. ### Example Input json { "query": "Software Engineer", "address": "San Francisco, CA", "radius": 50, "country": "US", "startPage": 1, "maxPages": 3, "pageSize": 20, "scrapeAllPages": false } ### Input Fields | Field | Type | Description | Default | Required | |-----------------|---------|-----------------------------------------------------------------------------|---------------|----------| | query | String | Job title or keyword (e.g., "Python Developer"). | "Python" | Yes | | address | String | City or address (e.g., "New York, NY"). | "New York, NY" | Yes | | radius | Integer | Search radius in miles (1–100). Larger radii return more jobs. | 20 | No | | country | String | Two-letter country code (e.g., "US"). | "US" | No | | startPage | Integer | Starting page number (minimum 1). | 1 | No | | maxPages | Integer | Number of pages to scrape (1–10). Ignored if scrapeAllPages is true. | 1 | No | | pageSize | Integer | Jobs per page (1–50). Higher values fetch more per request. | 20 | No | | scrapeAllPages| Boolean | Scrape all available pages (up to 10) instead of maxPages. | false | No | ### Tips - For a quick test, use the defaults. - For bulk data, set "scrapeAllPages": true or increase maxPages and pageSize. ## Output Data Format Each job listing is returned as a JSON object with detailed fields from Monster.com. Results are stored in Apify’s Dataset. ### Example Output (Single Job) json { "jobId": "46c85dc4-38cc-44c8-8687-e8493cafe78c", "externalIdentifiers": [ {"identifierName": "NOW_POSTING_ID", "identifierValue": "5764479b-114a-45a8-b030-934a4a28df13"}, {"identifierName": "POSITION_AD_ID", "identifierValue": "285910035"} ], "dateRecency": "22 days ago", "status": "ACTIVE", "jobType": "DURATION", "apply": { "applyType": "ONSITE", "applyUrl": "https://job-openings.monster.com/v2/job/apply?jobid=285910035" }, "jobPosting": { "description": "<div><strong>Since 2010 SynergisticIT has helped Jobseekers...</strong>...</div>", "baseSalary": { "currency": "USD", "value": {"minValue": 75000, "maxValue": 165000, "unitText": "Per Year"} }, "datePosted": "2025-02-28T23:45:14.000Z", "employmentType": ["FULL_TIME", "CONTRACTOR", "TEMPORARY"], "hiringOrganization": { "name": "SynergisticIT", "address": {"streetAddress": "Fremont", "addressRegion": "California", "addressCountry": "US"}, "logo": "https://securemedia.newjobs.com/clu/ximp/ximpetusitx/JobLogo.gif" }, "jobLocation": [{"address": {"addressRegion": "CA", "addressLocality": "San Francisco", "addressCountry": "US"}}], "title": "Software Engineer - Junior (Remote)" }, "provider": {"code": "monster"}, "brandingExt": { "companyBannerUrl": "https://media.newjobs.com/clu/ximp/ximpetusitx/branding/174866/SynergisticIT-banner-638061298089420191.jpg", "companyPhotos": [ {"url": "https://media.newjobs.com/clu/ximp/ximpetusitx/branding/174866/3d387cdf-1808-4512-8449-6fd1b1adda7f.jpeg"}, {"url": "https://media.newjobs.com/clu/ximp/ximpetusitx/branding/174866/4d9ae940-d39d-46f8-8e23-df9cbbc182db.jpeg", "caption": "SynergisticIT at Oracle Java ONE"} ] }, "enrichments": { "normalizedJobLocations": [{"postalAddress": {"address": {"addressRegion": "CA", "addressLocality": "San Francisco", "addressCountry": "US"}, "geo": {"latitude": "37.758081", "longitude": "-122.446549"}}}], "normalizedTitles": [{"title": "Software Engineer"}], "employmentTypes": [{"name": "TEMPORARY"}, {"name": "FULL_TIME"}, {"name": "CONTRACTOR"}] }, "formattedDate": "2025-02-28T00:00:00" } ### Key Output Fields | Field | Description | |----------------------|-----------------------------------------------------------------------------| | jobId | Unique identifier for the job listing. | | dateRecency | How long ago the job was posted (e.g., "22 days ago"). | | jobPosting.title | Job title (e.g., "Software Engineer - Junior (Remote)"). | | jobPosting.description | HTML-formatted job description. | | jobPosting.baseSalary | Salary range (e.g., $75,000–$165,000 USD per year). | | jobPosting.employmentType | Job types (e.g., "FULL_TIME", "CONTRACTOR"). | | jobPosting.hiringOrganization | Company details (name, address, logo). | | jobPosting.jobLocation | Job location (city, region, country). | | apply.applyUrl | URL to apply for the job. | | enrichments | Normalized data (locations, titles, employment types). | > Note: The full output includes additional metadata (e.g., brandingExt, provider). See the example above for the complete structure. ## Getting Started 1. Clone or Deploy: Use this Actor on Apify (e.g., apify push). 2. Run: Paste the input JSON into the Apify Console’s "Input" tab or call via API. 3. Download: Access results in the "Dataset" tab as JSON, CSV, or Excel. ## Tips for Best Results - Broad Searches: Use a larger radius (e.g., 50) or scrapeAllPages: true to get more jobs. - Targeted Scraping: Set startPage and maxPages for specific page ranges. - Monitor Costs: Larger pageSize and maxPages increase data volume (and Apify credits). ## Support Questions? Reach out on the Apify Community or file an issue on this repository. Happy scraping!