plainfold/company-hiring-signals
plainfold--company-hiring-signalsDestructive
This tool calls the Actor "plainfold/company-hiring-signals" and retrieves its output results. Actor description: Get any company's open jobs from its website: auto-detects Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee & more. Normalized jobs plus a hiring summary: departments, locations, new roles, velocity. No API key. $0.003/company, $0.001/job, $0.0005/run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| companies | Yes | **REQUIRED** Companies to check, one per entry. Best: the company website domain ("ramp.com"); the Actor reads its homepage and careers page to find the job board, then falls back to the board name on each supported ATS. Also accepted: a job-board URL ("https://jobs.lever.co/spotify", "https://job-boards.greenhouse.io/stripe"), "ats:slug" ("greenhouse:stripe", "ashby:ramp", "smartrecruiters:ServiceNow") or a plain company name ("Hugging Face"; least reliable). [Description truncated] Example values: ["ramp.com","https://jobs.lever.co/spotify","greenhouse:stripe"] | |
| remoteOnly | No | Return only jobs that can be done remotely (remote: true). Default: false. | |
| includeJobs | No | Return one dataset item per job (charged per job). Set false to get only the per-company hiring summaries (cheapest way to monitor many companies). Default: true. Example values: true | |
| postedSince | No | Optional: return only jobs first posted on or after this point, for monitoring new roles. Either a date ("2026-10-01") or a window back from now ("24 hours", "7 days", "2 weeks", "1 month"). Jobs without a posting date (BambooHR) are excluded when this is set. The company summary always describes all open roles and adds newSinceCount. Empty = all open jobs. | |
| titleKeywords | No | Optional: return only jobs whose title contains any of these words (case-insensitive), e.g. ["engineer", "sales"]. The summary still covers all roles. | |
| locationKeywords | No | Optional: return only jobs whose location or country contains any of these, e.g. ["New York", "Remote", "GB"]. | |
| maxJobsPerCompany | No | Maximum jobs returned per company after filters, newest first (each job is one charge). The summary always counts every open role. Default: 200. Example values: 200 | |
| includeDescription | No | Add a plain-text description (up to 4,000 characters, emails and phone numbers removed) to each job where the ATS feed provides one (not SmartRecruiters, Breezy or BambooHR). Makes output larger. Default: false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |