{ "openapi": "3.0.1", "info": { "title": "Foundit Jobs Scraper", "description": "Scrape Foundit (ex Monster India) jobs from its 7 country sites — India, Singapore, Malaysia, Indonesia, Hong Kong, Philippines, Gulf: title, company, salary, experience, skills, recruiter name, applicants, apply link. Up to 9 500 jobs per search.", "version": "0.0", "x-build-id": "4cCR6htc2VzYWh6JR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~foundit-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-foundit-jobs-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/nice_dev~foundit-jobs-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-foundit-jobs-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/nice_dev~foundit-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-foundit-jobs-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Foundit search-result URLs of any of the 7 country sites (`https://www.foundit.in/srp/results?query=python&locations=Bangalore&experienceRanges=2~5`, `https://www.foundit.sg/search/engineer-jobs`, `https://www.foundit.in/search/infosys-limited-639690-jobs-career`: keyword, location and every filter of the URL are kept, pagination is automatic) or single job URLs (`https://www.foundit.in/job/python-developer-infosys-limited-bengaluru-bangalore-69512911`). When this list is not empty, the search fields below are ignored; filters, caps and monitoring still apply. Max 1 000 URLs. Foundit filters set below are added to the URL's own; when both set the same filter, the URL wins.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "jobIds": { "title": "Job ids", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Foundit job ids (the number at the end of a job URL, `69512911`) to extract directly, like pasting their job URLs, read on the site chosen in **Country**. When this list is not empty, the search fields are ignored.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country site", "enum": [ "india", "singapore", "malaysia", "indonesia", "hongkong", "philippines", "gulf" ], "type": "string", "description": "Which Foundit site to search. Salaries are in that site's currency (INR, SGD, MYR, IDR, HKD, PHP, AED…).", "default": "india" }, "countries": { "title": "More country sites", "uniqueItems": true, "type": "array", "description": "Search several Foundit sites in one run: each search below is run on each site chosen here, added to **Country site**. Jobs found by several searches are saved once.", "items": { "type": "string", "enum": [ "india", "singapore", "malaysia", "indonesia", "hongkong", "philippines", "gulf" ], "enumTitles": [ "India (foundit.in)", "Singapore (foundit.sg)", "Malaysia (foundit.my)", "Indonesia (foundit.id)", "Hong Kong (foundit.hk)", "Philippines (foundit.com.ph)", "Gulf: UAE, Saudi Arabia, Qatar… (founditgulf.com)" ] }, "default": [] }, "query": { "title": "Search keywords", "maxLength": 200, "type": "string", "description": "Job title, skill, designation or company, as typed in the Foundit search box (`python developer`, `sales`, `data analyst`). Several words separated by commas = any of them (`python, java`). Empty = every job of the location and filters; empty with nothing else at all (no location, Foundit filter, other country site, start URL or job id) = a short example run (`python` in Bangalore, 20 jobs)." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location and each country site). Added to **Search keywords**; jobs found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City as typed on Foundit, no id needed: `Bangalore`, `Pune`, `Delhi`, `Singapore`, `Dubai`. Several cities separated by commas = any of them. Empty = the whole country site (with a keyword or a Foundit filter; with nothing else at all, the example run: `python` in Bangalore)." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every keyword is searched in every location (3 keywords × 4 locations = 12 searches, max 500). Added to **Location**.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max jobs", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of jobs to save for the whole run (after deduplication and filters). 0 = no limit. One Foundit search gives up to 9 500 jobs; bigger searches are split automatically by city.", "default": 100 }, "maxItemsPerQuery": { "title": "Max jobs per search", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap for EACH search (keyword × location × country site, or search URL), so that the first search cannot use up the whole **Max jobs** budget. 0 = no per-search cap.", "default": 0 }, "experience": { "title": "Years of experience", "minimum": 0, "maximum": 50, "type": "integer", "description": "Your experience in years: Foundit keeps the jobs whose experience range includes it (`3` = jobs open to 3 years: `2-5`, `3-7`, `1-3`). Empty = all. To bound the range itself, use **Experience asked** below." }, "salaryMin": { "title": "Salary from (per year)", "minimum": 0, "maximum": 999999999, "type": "integer", "description": "Yearly salary in the currency of the country site, in full (`1000000` = ₹10 lakhs on foundit.in). Foundit keeps the jobs whose salary range overlaps **Salary from** – **Salary to**, including the jobs that hide their salary from candidates. Empty = all." }, "salaryMax": { "title": "Salary to (per year)", "minimum": 0, "maximum": 999999999, "type": "integer", "description": "Upper end of the yearly salary band, same currency. Empty = no upper end." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Jobs posted in the last N days (Foundit's own freshness filter: `1`, `3`, `7`, `15`, `30` like the website, any other number works too). For an exact date range use **Posted after** / **Posted before** below." }, "jobTypes": { "title": "Job type", "uniqueItems": true, "type": "array", "description": "Several = any of them. Empty = all.", "items": { "type": "string", "enum": [ "workFromHome", "permanent", "contract", "walkin", "women" ], "enumTitles": [ "Work from home", "Permanent", "Contract", "Walk-in interview", "Jobs for women" ] }, "default": [] }, "employmentTypes": { "title": "Employment type", "uniqueItems": true, "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "fullTime", "partTime" ], "enumTitles": [ "Full time", "Part time" ] }, "default": [] }, "postedBy": { "title": "Posted by", "enum": [ "any", "company", "consultant" ], "type": "string", "description": "Jobs posted by the hiring company itself, or by recruitment consultants (agencies).", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the jobs. With a cap (**Max jobs**), `Date` gives the newest jobs. Relevance can skip a few jobs on long searches (the site reorders them while they are read); date reads every job once. **Posted after** and **Only new jobs** always read by date (newest first), whatever is chosen here.", "default": "date" }, "industries": { "title": "Industries", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Industry names exactly as Foundit shows them (`IT/Computers - Software`, `Banking/Accounting/Financial Services`). Several = any of them. Case ignored. Tip: copy them from the `industries` field of a first run.", "default": [], "items": { "type": "string" } }, "functions": { "title": "Job functions", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Function names exactly as Foundit shows them (`IT`, `Sales/Business Development`, `Finance & Accounts`). Several = any of them. Tip: copy them from the `functions` field of a first run.", "default": [], "items": { "type": "string" } }, "companies": { "title": "Companies (names)", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Only the jobs of these companies, full names as Foundit shows them (`Infosys Limited`, `Accenture Solutions Pvt Ltd`). Combine with an empty keyword to get every open job of a company. For a partial name use **Exclude companies** or the keyword field.", "default": [], "items": { "type": "string" } }, "companyIds": { "title": "Companies (Foundit ids)", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Only the jobs of these companies: Foundit company ids (`639690` = Infosys Limited) — the `companyId` field of any result, or the number in a company jobs URL (`/search/infosys-limited-639690-jobs-career`).", "default": [], "items": { "type": "string" } }, "quickApplyOnly": { "title": "Quick apply only", "type": "boolean", "description": "Keep only the jobs that can be applied for in one click on Foundit.", "default": false }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Open each job (1 extra request per job): full description (HTML and text), all IT skills, every location with state and GPS coordinates, job views, industries, apply URL of the employer, and the company card (city, country, industries, about). Charged per job whose page is read (event `result-with-details`, see the pricing). Unticked (default) = the fields of the results list only (faster, cheaper): title, company and profile, salary, experience, skills, applicants, recruiter name, dates, apply link…", "default": false }, "includeRecruiterPhone": { "title": "Add the recruiter's phone", "type": "boolean", "description": "Adds the recruiter's phone and the phone numbers written in the job text (with job details). `recruiterPhone` is the mobile number the recruiter published with the job (no extra request): Foundit shows a real one on about 1 job in 5 posted directly on Foundit, almost never on jobs copied from other sites. `descriptionPhones` lists the numbers the employer wrote in the job text (about 1 job in 16, copied jobs included). Placeholders (`None`, a company switchboard repeated on hundreds of jobs, wrong length) and example numbers are removed. Charged once per job delivered WITH at least one number (event `recruiter-phone`, see the pricing); unticked (default) = never charged.", "default": false }, "includeMarketStats": { "title": "Add market statistics per search", "type": "boolean", "description": "Adds one record, `MARKET_STATS`, to the run's key-value store (Output tab): one sheet per search, computed on the jobs read: total jobs on Foundit, top hiring companies, cities, salary bands (min / median / max), experience asked, top skills, work from home share, company vs consultant, jobs posted on Foundit vs copied from other sites, quick apply share. One sheet per search you typed or pasted (not per part of a split search), no extra request; a search not read because `maxItems` was reached first has no sheet (set `maxItemsPerQuery` to read every search). Charged once per sheet (event `market-stats`, see the pricing); a search with no job gets a sheet of 0 jobs, never charged; unticked (default) = never charged.", "default": false }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only jobs posted on or after this date (Foundit's posting date, `publishedAt`): `2026-09-01`, or a period before now such as `7 days`, `24 hours`, `2 weeks`, `1 month` (full ISO date-times work too). A date without a time starts at midnight India time (UTC+5:30), whatever the site." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only jobs posted on or before this date (the whole day is included, India time whatever the site), or older than a period such as `30 days`." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the jobs whose title contains one of these texts (case and accents ignored). A text inside a longer word counts too: `intern` also drops \"International Sales\".", "default": [], "items": { "type": "string" } }, "includeKeywords": { "title": "Include keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Keep only the jobs whose title, company name or skills contain at least one of these words (case and accents ignored). With **Extract details**, the full description is read too. Empty = all.", "default": [], "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the jobs whose company name contains one of these words (`Infosys`, `staffing`). Case and accents ignored.", "default": [], "items": { "type": "string" } }, "experienceMin": { "title": "Experience asked: at least (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Keep only the jobs whose experience range reaches this number of years (`5` keeps `3-7 Years` and `5-10 Years`, drops `0-2 Years`). Jobs without an experience range are left out. A minimum above the maximum is refused." }, "experienceMax": { "title": "Experience asked: at most (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Keep only the jobs whose experience range starts at or below this number of years (`2` keeps `0-1 Years` and `2-5 Years`, drops `3-7 Years`; `0` = fresher jobs). Jobs without an experience range are left out." }, "onlyWithSalary": { "title": "Only with a visible salary", "type": "boolean", "description": "Keep only the jobs that show their salary to candidates (few do: under 1 in 10 on foundit.in).", "default": false }, "jobSource": { "title": "Job source", "enum": [ "any", "native", "reposted" ], "type": "string", "description": "Foundit copies many jobs from employers' career sites and other job boards (about 9 in 10 on foundit.in). `Posted on Foundit` keeps the jobs a recruiter posted on Foundit itself (with recruiter name and, sometimes, phone); `Copied from other sites` keeps the others (with the original apply URL).", "default": "any" }, "greatPlaceToWorkOnly": { "title": "Great Place To Work companies only", "type": "boolean", "description": "Keep only the jobs of companies certified Great Place To Work (badge shown by Foundit).", "default": false }, "urgentOnly": { "title": "Urgently hiring only", "type": "boolean", "description": "Keep only the jobs marked \"Urgently hiring\" by the employer.", "default": false }, "excludeHiddenCompanies": { "title": "Exclude confidential companies", "type": "boolean", "description": "Drop the jobs whose employer hides its name.", "default": false }, "maxItemsPerCompany": { "title": "Max jobs per company", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Keep at most this many jobs of the same company in the run (the first ones read). 0 = no cap.", "default": 0 }, "requirePhone": { "title": "Only with a recruiter phone", "type": "boolean", "description": "Keep only the jobs with a real recruiter phone number. Needs **Add the recruiter's phone** (the run is refused without it).", "default": false }, "onlyNew": { "title": "Only new jobs", "type": "boolean", "description": "Skip the jobs that a previous run (same **Memory key**) already delivered: they are not saved and not charged and, for jobs found by a search, their page is not even opened. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new jobs**. Give each schedule / task its own key (e.g. `python-bangalore`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every job again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 8 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Most requests to the site in any 60 seconds, all of them counted: results pages, listing pages and the extra page read for a listing. A budget, not an even pace: up to this many can leave at once when the minute starts (spread them with the minimum delay below). Lower it if the site answers HTTP 429 / 403 in the log.", "default": 120 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute rate, this spreads the requests evenly instead of letting them go out in a burst. 0 = no gap.", "default": 0 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the site turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }