# ZipRecruiter Job Scraper (`rigelbytes/ziprecruiter-scraper`) Actor Scrape job listings from ZipRecruiter with search queries, locations, and radius filters. Extracts title, company, location, description, employment type, and more from structured data. - **URL**: https://apify.com/rigelbytes/ziprecruiter-scraper.md - **Developed by:** [Rigel Bytes](https://apify.com/rigelbytes) (community) - **Categories:** Jobs, Lead generation, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 jobs This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ZipRecruiter Job Scraper Extract thousands of job listings from ZipRecruiter to power market research, salary benchmarking, and automated job alerts — for just **$1** per 1,000 jobs. --- ### What can ZipRecruiter Job Scraper do for you? - **Build a custom job database** — Collect titles, companies, locations, descriptions, and employment types from any ZipRecruiter search query. - **Monitor salary trends** — Track compensation data across regions, industries, and job types with structured, normalized output. - **Automate job alert systems** — Feed scraped listings into your own platform, dashboard, or CRM without manual copy-paste. - **Analyze hiring demand** — Understand which skills, locations, and roles employers are posting for — in real time. - **Enrich recruitment workflows** — Use structured job data to power internal tools, recommendation engines, or market intelligence reports. ### What data can you extract? | Field | Description | |-------|-------------| | 🏷️ **Job Title** | Full job posting title | | 🏢 **Company Name** | Hiring organization name | | 🌍 **Location** | City, state/region, country, and postal code | | 📄 **Description** | Full job description text | | 💼 **Employment Type** | Full-time, part-time, contract, etc. | | 📅 **Date Posted** | When the listing was published | | 🔗 **Job URL** | Direct link to the original posting | | ✅ **Direct Apply** | Whether the job supports direct applications | | 📍 **Coordinates** | Latitude and longitude of the job location | | 🏛️ **Company URL** | Company website and social links | ### Why use this scraper? - 🔬 **Market Research** — Analyze job market trends, in-demand skills, and salary ranges across industries and locations. - 📊 **Competitive Intelligence** — Track which companies are hiring, where, and for what roles to spot industry shifts. - ⚙️ **Process Automation** — Replace manual job board browsing with structured, scheduled data extraction. - 📈 **Data-Driven Hiring** — Build your own job aggregation platform or feed data into analytics dashboards. ### Pricing - **$1/1,000 jobs** - No hidden fees or limits on usage. --- ### How to use ZipRecruiter Job Scraper 1. **Create a free Apify account** at [console.apify.com](https://console.apify.com). 2. **Open the ZipRecruiter Job Scraper** and click **Try for free**. 3. **Enter your search terms** — Add job titles, keywords, locations, and radius. 4. **Configure advanced options** — Set a maximum job limit or proxy preferences. 5. **Start the scrape** — Click **Run** and wait for the results. 6. **Download your data** — Export as JSON, CSV, or Excel from the dataset. ### Input The actor accepts the following input parameters: | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQueries` | array | ✅ Yes | Job search terms (e.g., "Python Developer", "Data Scientist") | | `locations` | array | ❌ No | Job locations (e.g., "Berlin", "New York, NY"). Leave empty for nationwide search | | `radius` | integer | ❌ No | Search radius in miles (0 = any distance). Range: 0–200 | | `maxJobs` | integer | ❌ No | Maximum number of job listings to scrape (0 = unlimited) | | `proxyConfiguration` | object | ❌ No | Proxy settings for anti-bot protection | #### 📝 Copy for Use: ```json { "searchQueries": ["Web Developer"], "locations": ["Berlin"], "radius": 0, "maxJobs": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### 🖼️ Output ![ZipRecruiter Job Scraper Output](https://github.com/faizanalii/apify-images/blob/main/ZipRecruiter%20Job%20Scraper.gif?raw=true) [![Detailed Data](https://img.shields.io/badge/Detailed%20Data-JSON-blue?style=for-the-badge)](#detailed-data) ### Why Choose This Scraper? - **Affordable**: Pay only $1 per 1,000 jobs scraped. - **Comprehensive**: Extract 16+ data points per listing including title, company, full description, location, employment type, and geo-coordinates. - **Easy to Use**: Simple input schema — just enter search terms and locations to start scraping immediately. - **Reliable**: Built with Chrome TLS impersonation, automatic retries, and residential proxy support for consistent results. ### Recommended Proxy Providers - ## **Shifter** - Reliable residential proxies all over the world. - Cheap rates - [Order Shifter Now](https://shifter.io/r/YoBB/order) - Get 10% Off any product, use coupan `rigelbytes-YoBB`. - ## **OxyLabs** - **100M+ Proxies** - Fastest proxies in the market - Real profile, human-like Residential IPs - Quality assurance framework for most reliable IPs - [Get Proxies](https://oxylabs.go2cloud.org/aff_c?offer_id=7\&aff_id=1366\&url_id=7) - ## **DataImpulse** - Covers **200+ Counties** - Reliable Residential Proxies for just $1/GB - [Get Residential Proxies](https://dataimpulse.com/?aff=89421) ### [![Learn More About Proxies](https://img.shields.io/badge/Learn_More-About_Proxies-blue?style=for-the-badge)](#understanding-proxies) ### 🙌 Why Buy Through Our Affiliate Link? - Exclusive Deals: Some providers may offer special discounts or bonuses when you use our link. - Support Our Work: Each purchase helps us maintain and improve the tools and services we provide. - No Extra Cost: You pay the same price, but part of it goes to supporting our efforts. #### Running via Apify Console You can run this actor from the Apify Console by providing the necessary input parameters. #### Running via API You can trigger this actor using the Apify API, passing the required input in the request body. ### API Examples #### Python ```shell from apify_client import ApifyClient client = ApifyClient("YOUR-API-TOKEN") run_input = { "searchQueries": ["Web Developer"], "locations": ["Berlin"], "radius": 0, "maxJobs": 5, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"] }, } run = client.actor("rigelbytes/ziprecruiter-scraper").call(run_input=run_input) ``` #### JavaScript ```shell import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR-API-TOKEN' }); const runInput = { searchQueries: ["Web Developer"], locations: ["Berlin"], radius: 0, maxJobs: 5, proxyConfiguration: { useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"] }, }; const run = await client.actor("rigelbytes/ziprecruiter-scraper").call(runInput); ``` #### cURL ```shell curl "https://api.apify.com/v2/acts/rigelbytes~ziprecruiter-scraper/runs?token=YOUR-API-TOKEN" \ -X POST \ -H "Content-Type: application/json" \ -d '{ "searchQueries": ["Web Developer"], "locations": ["Berlin"], "radius": 0, "maxJobs": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } }' ``` ### 🚀 Other Tools by Rigel Bytes Explore **75** more scraping tools by Rigel Bytes, organized by use case: #### 📱 Social Media Scrape Instagram, TikTok, LinkedIn, and more for content research and marketing intelligence. - **[Export Instagram Reels](https://apify.com/rigelbytes/export-instagram-reels)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Facebook Ads Scraper](https://apify.com/rigelbytes/facebook-ads-scraper)** — Extract posts, profiles, and engagement data from Facebook for content research, influencer tracking, and marketing analytics. - **[Instagram Analytics Tool](https://apify.com/rigelbytes/instagram-analytics-tool)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Comment Scraper](https://apify.com/rigelbytes/instagram-comment-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Creator Stats](https://apify.com/rigelbytes/instagram-creator-stats)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Engagement Tool](https://apify.com/rigelbytes/instagram-engagement-tool)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Post Scraper](https://apify.com/rigelbytes/instagram-post-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[instagram-posts](https://apify.com/rigelbytes/instagram-posts)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Profile Scraper](https://apify.com/rigelbytes/instagram-profile-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Reel Scraper](https://apify.com/rigelbytes/instagram-reel-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[linkedin-company-details](https://apify.com/rigelbytes/linkedin-company-details)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Linkedin Company Scraper](https://apify.com/rigelbytes/linkedin-company-scraper)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[LinkedIn Profile Scraper](https://apify.com/rigelbytes/linkedin-profile-scraper)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Scrape Instagram Creators](https://apify.com/rigelbytes/scrape-instagram-creators)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Tiktok Comment Scraper](https://apify.com/rigelbytes/tiktok-comment-scraper)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Creator Stats](https://apify.com/rigelbytes/tiktok-creator-stats)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Engagement Rate](https://apify.com/rigelbytes/tiktok-engagement-rate)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[TikTok Profile Scraper](https://apify.com/rigelbytes/tiktok-profile-scraper)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. #### 🏠 Real Estate Extract property listings, prices, and agent data from top real estate platforms. - **[Airbnb Address Finder](https://apify.com/rigelbytes/airbnb-address-finder)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Availability Calendar](https://apify.com/rigelbytes/airbnb-availability-calendar)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Detailed Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-detailed-scraper)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Images Downloader](https://apify.com/rigelbytes/airbnb-images-downloader)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing](https://apify.com/rigelbytes/airbnb-listing)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing Urls](https://apify.com/rigelbytes/airbnb-listing-urls)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Property Details](https://apify.com/rigelbytes/airbnb-property-details)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Reviews](https://apify.com/rigelbytes/airbnb-reviews)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-scraper)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Bayut Scraper](https://apify.com/rigelbytes/bayut-scraper)** — Scrape property listings and market data from Bayut for market research, price monitoring, and investment analysis. - **[Boligsiden.dk Scraper](https://apify.com/rigelbytes/boligsiden-dk-scraper)** — Scrape Danish real estate listings from Boligsiden.dk — for sale, sold, and rental properties with pricing, details,... - **[Daft.ie Property Scraper](https://apify.com/rigelbytes/daft-ie-scraper)** — Scrapes property listings from Daft.ie including residential, rental, commercial, and new homes across Ireland. - **[dubai-listing-scraper](https://apify.com/rigelbytes/dubai-listing-scraper)** — Extract unlimited property listings from Bayut.com — the UAE's largest real estate platform. Get detailed property... - **[Export Airbnb Calendar](https://apify.com/rigelbytes/export-airbnb-calendar)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Funda Netherlands Real Estate Scraper](https://apify.com/rigelbytes/funda-nl-scraper)** — Scrape property listings from Funda.nl — the largest real estate platform in the Netherlands. Supports buy and rent,... - **[Furnished Finder Fast](https://apify.com/rigelbytes/furnished-finder-fast)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[Extract Furnished Finder Hosts](https://apify.com/rigelbytes/furnished-finder-hosts)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[FurnishedFinder](https://apify.com/rigelbytes/furnishedfinder)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[Hemnet.se Scraper - Swedish Real Estate Listings](https://apify.com/rigelbytes/hemnet-se-scraper)** — Scrape property listings from Hemnet.se including for-sale, upcoming, and sold homes. Search by URL or location... - **[Immobiliare Italy Real Estate Scraper](https://apify.com/rigelbytes/immobiliare-it-scraper)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24](https://apify.com/rigelbytes/immobilienscout24)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24-scraper](https://apify.com/rigelbytes/immobilienscout24-scraper)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immoweb Scraper - Belgium Property Listings](https://apify.com/rigelbytes/immoweb-scraper)** — Scrapes property listings from Immoweb.be. Supports search result extraction with optional property detail enrichment. - **[Immowelt Property Scraper](https://apify.com/rigelbytes/immowelt-property-scraper)** — The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including... - **[Immowelt Scraper](https://apify.com/rigelbytes/immowelt-scraper)** — The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including... - **[Land.com Scraper](https://apify.com/rigelbytes/landdotcom-scraper)** — Scrape property listings and market data from Land.com for market research, price monitoring, and investment analysis. - **[Outdoorsy Scraper](https://apify.com/rigelbytes/outdoorsy-scraper)** — Scrape property listings and market data from Outdoorsy for market research, price monitoring, and investment analysis. - **[Propertyfinder Scraper](https://apify.com/rigelbytes/propertyfinder-scraper)** — Scrape property listings and market data from Property Finder for market research, price monitoring, and investment analysis. - **[Redfin Scraper](https://apify.com/rigelbytes/redfin-scraper)** — Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[Rightmove Scraper](https://apify.com/rigelbytes/rightmove-scraper)** — Scrape property listings and market data from Rightmove for market research, price monitoring, and investment analysis. - **[RVshare Scraper](https://apify.com/rigelbytes/rvshare-scraper)** — Scrape property listings and market data from RVshare for market research, price monitoring, and investment analysis. - **[Unlimited Redfin Scraper](https://apify.com/rigelbytes/unlimited-redfin-scraper)** — Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[Zillow Detail Scraper](https://apify.com/rigelbytes/zillow-detail-scraper)** — Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zillow Scraper](https://apify.com/rigelbytes/zillow-scraper)** — Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zoopla Scraper](https://apify.com/rigelbytes/zoopla-scraper)** — Scrape property listings and market data from Zoopla for market research, price monitoring, and investment analysis. #### ✈️ Travel & Hospitality Monitor rentals, bookings, and travel listings at scale. - **[CarMax Scraper](https://apify.com/rigelbytes/carmax-scraper)** — Scrapes used car listings from CarMax.com with search URL, zip code filtering, and pagination support. - **[Ticketmaster Scraper](https://apify.com/rigelbytes/ticketmaster-scraper)** — Collect rental and travel listings from Ticketmaster for pricing intelligence and availability tracking. #### 🛒 E-commerce Scrape products, prices, and marketplace data for competitive research. - **[Amazon Product Scraper](https://apify.com/rigelbytes/amazon-product-scraper)** — Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[Amazon Search Scraper](https://apify.com/rigelbytes/amazon-scraper)** — Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[Daraz](https://apify.com/rigelbytes/daraz)** — Scrape products, prices, and seller data from Daraz for competitor monitoring, pricing, and product research. - **[Etsy Scraper](https://apify.com/rigelbytes/etsy-scraper)** — Scrape products, prices, and seller data from Etsy for competitor monitoring, pricing, and product research. - **[Homedepot Scraper](https://apify.com/rigelbytes/homedepot-scraper)** — HomeDepot Products Scraper lets you extract product data from homedepot.com using a collection URL and delivery ZIP.... - **[Otodom Scraper - Polish Real Estate Listings](https://apify.com/rigelbytes/otodom-scraper)** — Scrapes property listings from Otodom.pl, Poland's leading real estate marketplace. Supports filters for transaction... #### 📩 Lead Generation Find business contacts, leads, and company data for sales and outreach. - **[Company Service Finder](https://apify.com/rigelbytes/company-service-finder)** — The Company Service Finder uses AI to extract and analyze company services from Google Search & Maps. Get detailed... - **[Doctify Scraper](https://apify.com/rigelbytes/doctify-scraper)** — Doctify Scraper lets you extract doctor and practice data from doctify.com using a search results URL. Collect... - **[FindLaw Law Firm Scraper - Attorney & Law Firm Data Extraction](https://apify.com/rigelbytes/findlaw-scraper)** — Scrape law firm profiles from FindLaw.com. Extract detailed attorney and firm information including contact details,... - **[Google Maps Scraper](https://apify.com/rigelbytes/google-maps-scraper)** — Find business leads and contact details from Google Maps for outbound sales, prospecting, and CRM enrichment. - **[Website Services Finder](https://apify.com/rigelbytes/website-services-finder)** — Automatically extract and analyze company services from any business website using advanced AI. Choose from 5 AI... - **[Zillow Agents](https://apify.com/rigelbytes/zillow-agents)** — Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. - **[Zillow Agents Phone](https://apify.com/rigelbytes/zillow-agents-phone)** — Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. #### ⭐ Reviews & Ratings Monitor reviews and reputation data across review platforms. - **[Airbnb Listing Reviews](https://apify.com/rigelbytes/airbnb-listing-reviews)** — Collect reviews and ratings from Airbnb for reputation monitoring and customer insights. - **[BBB Scraper](https://apify.com/rigelbytes/bbb-scraper)** — Collect reviews and ratings from BBB for reputation monitoring and customer insights. - **[Rottentomatoes Reviews Scraper](https://apify.com/rigelbytes/rottentomatoes-reviews-scraper)** — Collect reviews and ratings from Rotten Tomatoes for reputation monitoring and customer insights. - **[Trustpilot Reviews Scraper](https://apify.com/rigelbytes/trustpilot-reviews)** — Collect reviews and ratings from Trustpilot for reputation monitoring and customer insights. #### 🍔 Food & Delivery Extract restaurant, grocery, and delivery platform data. - **[Instacart Scraper](https://apify.com/rigelbytes/instacart-scraper)** — Scrape menus, stores, and delivery data from Instacart for data-driven research and automation. - **[Publix Scraper](https://apify.com/rigelbytes/publix-scraper)** — Scrape menus, stores, and delivery data from Publix for data-driven research and automation. #### 🛠️ Developer Tools General-purpose scraping and automation tools. - **[Web Crawler](https://apify.com/rigelbytes/webcrawler)** — This web crawler is designed to provide users with complete flexibility by allowing them to use their \*\*own... ### Understanding Proxies: When scraping data or browsing anonymously, proxies are essential. They act as intermediaries, masking your original IP address and allowing you to send requests from another location. #### Why Use Proxies? - Avoid IP Blocks: By routing requests through proxies, you prevent the target website from recognizing your IP as a scraper or spammer. - Access Geo-restricted Content: Proxies let you access content or websites restricted by location. - Enhance Anonymity: Hide your actual IP, ensuring privacy while scraping or browsing. #### Types of Proxies 1. Residential Proxies - Real IP addresses provided by ISPs to home users. - They mimic regular users, making them harder to detect. - Best for: Long-term, undetectable scraping, and avoiding blocks. 2. Data Center Proxies - IP addresses from servers in data centers. - Faster and cheaper than residential proxies but easier to detect and block. - Best for: High-speed scraping, but with a higher risk of detection. 3. Mobile Proxies - IPs provided by mobile carriers (3G/4G/5G networks). - Very difficult to detect, as they appear as regular mobile users. - Best for: Mobile-related scraping or avoiding sophisticated blocks. #### Rotating Proxies vs. Straight Proxies - Rotating Proxies: Every request you send goes through a different proxy, making it harder for websites to detect patterns. - Straight Proxies: All requests are sent through the same proxy, making it easier to track your IP. ### About Rigel Bytes Rigel Bytes specializes in web scraping, automation, and data analytics. We help businesses extract and leverage valuable data for informed decision-making. ### Contact Us Ready to unlock the power of data? Reach out to us at (contact@rigelbytes.com) or [book an appointment](https://cal.com/faizanali/appointments) with us to learn more about how we can help you achieve your data goals. ### Detailed Data ```json [ { "title": "Web Developer", "url": "https://www.ziprecruiter.com/jobs/web-developer-123", "datePosted": "2025-01-15", "validThrough": "2025-03-15", "description": "We are looking for a skilled Web Developer to join our team...", "employmentType": "FULL_TIME", "directApply": true, "companyName": "Tech Corp", "companyUrl": "https://techcorp.com", "companySameAs": "", "locationLocality": "Berlin", "locationRegion": "Berlin", "locationCountry": "DE", "locationPostalCode": "10115", "latitude": "52.5200", "longitude": "13.4050" }, { "title": "Senior Frontend Engineer", "url": "https://www.ziprecruiter.com/jobs/senior-frontend-engineer-456", "datePosted": "2025-01-14", "validThrough": "2025-02-28", "description": "Senior Frontend Engineer position at a leading SaaS company...", "employmentType": "FULL_TIME", "directApply": false, "companyName": "SaaS Solutions Inc.", "companyUrl": "https://saas-solutions.com", "companySameAs": "https://linkedin.com/company/saas-solutions", "locationLocality": "New York", "locationRegion": "NY", "locationCountry": "US", "locationPostalCode": "10001", "latitude": "40.7128", "longitude": "-74.0060" } ] ``` # Actor input Schema ## `searchQueries` (type: `array`): Job titles, skills, or keywords (e.g. "Python Developer", "Data Scientist", "Registered Nurse Brooklyn"). Primary input for AI agents — no URL required. Combine with Locations below for location-specific searches. ## `startUrls` (type: `array`): Full ZipRecruiter search URLs copied from your browser (e.g. https://www.ziprecruiter.de/jobs/search?q=python\&l=Berlin). Optional override for power users — ignored when Search Queries are provided. ## `locations` (type: `array`): City, state, or country names (e.g. "Berlin", "New York, NY", "Remote"). Leave empty for nationwide or remote search. Combined with each Search Query. ## `radius` (type: `integer`): Search radius in miles from the location (0 = any distance). Applies to all location searches. ## `maxJobs` (type: `integer`): Maximum number of job listings to scrape (0 = unlimited). Use a specific number to control costs and runtime. ## `proxyConfiguration` (type: `object`): Proxy settings for anti-bot protection. Apify Residential proxy recommended for reliable scraping. ## Actor input object example ```json { "searchQueries": [ "Web Developer" ], "startUrls": [ { "url": "https://www.ziprecruiter.de/jobs/search?q=Web+Developer&l=Berlin" } ], "locations": [ "Berlin" ], "radius": 0, "maxJobs": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `dataset` (type: `string`): JSON array of scraped job records. Fetch this URL after the run completes to retrieve results. ## `run` (type: `string`): Apify Console link to inspect this run's logs, input, and output. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "Web Developer" ], "startUrls": [ { "url": "https://www.ziprecruiter.de/jobs/search?q=Web+Developer&l=Berlin" } ], "locations": [ "Berlin" ], "maxJobs": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("rigelbytes/ziprecruiter-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["Web Developer"], "startUrls": [{ "url": "https://www.ziprecruiter.de/jobs/search?q=Web+Developer&l=Berlin" }], "locations": ["Berlin"], "maxJobs": 20, } # Run the Actor and wait for it to finish run = client.actor("rigelbytes/ziprecruiter-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "Web Developer" ], "startUrls": [ { "url": "https://www.ziprecruiter.de/jobs/search?q=Web+Developer&l=Berlin" } ], "locations": [ "Berlin" ], "maxJobs": 20 }' | apify call rigelbytes/ziprecruiter-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rigelbytes/ziprecruiter-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ZipRecruiter Job Scraper", "description": "Scrape job listings from ZipRecruiter with search queries, locations, and radius filters. Extracts title, company, location, description, employment type, and more from structured data.", "version": "1.0", "x-build-id": "wF35uAE3cjowyI0Vc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~ziprecruiter-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-ziprecruiter-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rigelbytes~ziprecruiter-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-ziprecruiter-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rigelbytes~ziprecruiter-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-ziprecruiter-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Job titles, skills, or keywords (e.g. \"Python Developer\", \"Data Scientist\", \"Registered Nurse Brooklyn\"). Primary input for AI agents — no URL required. Combine with Locations below for location-specific searches.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Full ZipRecruiter search URLs copied from your browser (e.g. https://www.ziprecruiter.de/jobs/search?q=python&l=Berlin). Optional override for power users — ignored when Search Queries are provided.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locations": { "title": "Locations", "type": "array", "description": "City, state, or country names (e.g. \"Berlin\", \"New York, NY\", \"Remote\"). Leave empty for nationwide or remote search. Combined with each Search Query.", "default": [], "items": { "type": "string" } }, "radius": { "title": "Search Radius", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius in miles from the location (0 = any distance). Applies to all location searches.", "default": 0 }, "maxJobs": { "title": "Max Jobs", "minimum": 0, "type": "integer", "description": "Maximum number of job listings to scrape (0 = unlimited). Use a specific number to control costs and runtime.", "default": 0 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for anti-bot protection. Apify Residential proxy recommended for reliable scraping.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```