Hiring Trend Monitor by Job Function
Pricing
from $8.50 / 1,000 change founds
Hiring Trend Monitor by Job Function
Track comparable public hiring slices over time. Get explicit baselines, before/after function counts, materiality, confidence, source gaps, and review actions without fabricating growth on the first run.
Pricing
from $8.50 / 1,000 change founds
Rating
0.0
(0)
Developer
Tim Zinin
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Hiring Trend Index
Watch which job functions — engineering, sales, marketing, product, and 8 more — a company or a whole job market is hiring for, and get told what changed since your last check. Not a one-off count: a real trend, backed by your own history of checks.
What you get
Each run checks a small list of slices you choose and reports, per slice:
- First check ever for that slice — a baseline snapshot: how many open roles right now, broken down by function. This is billed once, the same as any other result — it's a real, useful snapshot, not filler.
- Every check after that — what changed since the last one: total open
roles delta, and a per-function breakdown (
growing/shrinking/flat, with the exact before/after counts).
A single run can never know "growth" on its own — that needs two points in time. This Actor is honest about that: it never reports a trend on a slice's first-ever check, only a snapshot labeled as such.
How to run it
- Click Try for free — no card needed on the free plan.
- In Slices to watch, add one entry per company, format
company:<ats-provider>:<token>(e.g.company:greenhouse:gitlab) — or justcompany:<token>(e.g.company:stripe) and this Actor auto-detects the ATS provider for you. - Optionally set a Watch name (
watch_key) if you're running more than one independent set of watches from the same Actor. - Hit Start. The first run for each slice creates a baseline (billed the same as any other result); every run after that compares against it and reports what changed, pulled from the dataset (UI, API or webhook).
Slices
Two kinds, as strings in the slices input:
company:<ats-provider>:<token>— a company's own public job board (Greenhouse, Lever, or Ashby), e.g.company:greenhouse:gitlab,company:ashby:ramp. You can also drop the provider (company:stripe) and the built-in adapter will auto-detect it.board:<name>[:<keyword>]— a sample from jobs.ch, Jobs.ge, XING Jobs or Boss.az (a whole country/market's currently open roles, not one company).
Default (and what the daily platform test runs): two well-known, already-verified company boards (GitLab and Stripe, both on Greenhouse).
What's live today
Both company:* and board:* slices use source adapters embedded in this
Actor. There is no child Actor run, buyer-token hand-off, or second Actor
charge. Supported boards are jobs-ch-swiss, jobs-ge, xing-jobs, and
boss-az; jobs.ch and Jobs.ge require a keyword.
Partial results
If one of your slices doesn't respond this run (a timeout, a typo in the slice
string, a sitemap/detail failure, or the buyer's charge limit running out
mid-run), the OTHER slices still deliver normally. You'll additionally get one
free summary row with partial: true, missingSlices, and source counters
naming exactly which slice(s) were incomplete and why. An incomplete slice
never advances its baseline.
Watching several independent trends
Use watch_key to run more than one independent set of watches from the same
Actor (e.g. "competitor-tracking" vs "my-own-hiring") without one run's memory
overwriting another's.
Pricing
Pay-per-event. The Actor accepts only Apify's exact six-tier contract: FREE
$0.005/$0.010, BRONZE $0.00475/$0.0095, SILVER $0.0045/$0.009, GOLD
$0.00425/$0.0085, PLATINUM $0.0041/$0.0082, or DIAMOND
$0.004/$0.008 per run start/result. A result is a complete slice snapshot
(including a safely confirmed fresh baseline). Empty/not-found, partial, and
error rows are free. A malformed pricing contract, exhausted budget, or
unconfirmed charge fails closed and never advances the affected baseline.
Input
| Field | Required | What it does |
|---|---|---|
slices | yes | 1-10 entries, one per company/board to track. company:<ats-provider>:<token> (provider optional, auto-detected) or board:<name>[:<keyword>]. |
watch_key | no | Name for this set of watches, so several independent watches from the same Actor don't overwrite each other's memory. Default apify-daily-test — replace it with your own. |
new_window_days | no | Company slices only: how many days back a posting still counts as "new" in the underlying signal. Default 30. |
{"slices": ["company:greenhouse:gitlab", "company:greenhouse:stripe"],"watch_key": "my-watch"}
Output
Real row from a live platform run (2026-07-30), company:greenhouse:gitlab
checked a second time — baseline already existed, so this is a trend
comparison, not a first-check snapshot:
{"slice": "company:greenhouse:gitlab","sliceKind": "company","token": "greenhouse:gitlab","source": "greenhouse","found": true,"baselineCreated": false,"totalOpenRoles": 183,"totalOpenRolesBaseline": 183,"totalOpenRolesDelta": 0,"trend": {"engineering": { "baseline": 55, "current": 55, "delta": 0, "direction": "flat" },"sales": { "baseline": 34, "current": 34, "delta": 0, "direction": "flat" },"support": { "baseline": 30, "current": 30, "delta": 0, "direction": "flat" },"other": { "baseline": 21, "current": 21, "delta": 0, "direction": "flat" }},"byFunction": {"engineering": 55,"sales": 34,"support": 30,"other": 21},"partial": false,"missingSlices": [],"checkedAt": "2026-07-30T11:28:31.999Z","error": "","summary": "\"company:greenhouse:gitlab\": 183 open role(s) now (+0 since last check)."}
| Field | Meaning |
|---|---|
found | true when the slice resolved to a real board; false for a not-found slice (see below). |
baselineCreated | true only on a slice's first-ever check for this watch_key — every later check is false. |
totalOpenRoles / totalOpenRolesDelta | Current open-role count and the change since the last check (0 for a first check's own baseline). |
trend | Per-function breakdown: baseline/current counts, delta, and direction (growing / shrinking / flat). Trimmed here to 4 functions; up to 12 come back in a real run. |
byFunction | Current open-role count per function, flat (no history). |
partial / partialReason / missingSlices / sourceStats | See "Partial results" above. These fields preserve board sitemap/detail failure and cap evidence instead of presenting an incomplete scan as complete. |
A not-found slice (verified live, 2026-07-30 — no such company on any supported ATS) looks like this and is never charged:
{"slice": "company:greenhouse:zzznonexistentcompany123456xyz","sliceKind": "company","token": "greenhouse:zzznonexistentcompany123456xyz","source": null,"found": false,"baselineCreated": false,"totalOpenRoles": null,"trend": null,"byFunction": null,"partial": false,"missingSlices": [],"checkedAt": "2026-07-30T11:28:39.692Z","error": "","summary": "No public job board found on greenhouse for \"zzznonexistentcompany123456xyz\". Check the ATS token (e.g. \"greenhouse:stripe\")."}
Other tools we built
Related tools
Related tools for adjacent workflows in B2B lead generation and data enrichment, jobs and hiring.
| Actor | What it does |
|---|---|
| Company Hiring Radar | Pair it in the jobs and hiring workflow: Pull every open role a company is hiring for from its public job board (Greenhouse, Lever, Ashby) and turn... |
| Jobs.ge Georgia Jobs Scraper | Pair it in the jobs and hiring workflow: Search Jobs.ge (Georgia, the country's oldest job board) and get public job listings: title, employer,... |
| Tech Stack Change Detector | Pair it in the B2B lead generation and data enrichment workflow: Detect a website's current technologies (CMS, ecommerce, analytics, marketing/CRM, framework, hosting/CDN,... |
| Computrabajo LatAm Jobs Scraper | Pair it in the jobs and hiring workflow: Search Computrabajo (Mexico, Colombia, Chile, Argentina, Peru) by keyword and get public job listings:... |
| Job Postings Aggregator | Pair it in the jobs and hiring workflow: Pull every open role from a company's public applicant-tracking system (Greenhouse, Lever, Ashby) and... |
FAQ / Limitations
Does the first check for a slice tell me anything useful? Yes — it's a real, billed snapshot of open roles right now, per function. It's just never labeled as a "trend", because a trend needs a prior check to compare against.
Greenhouse, Lever, and Ashby responses are validated as provider-specific job envelopes with HTTPS job identities. Schema drift is a source error, not a silent empty board. A present but malformed stored baseline is likewise fatal and is never replaced as though the slice were new.
What this is NOT. This is not an applicant-tracking or job-application tool. It reads public Greenhouse/Lever/Ashby boards and supported public job markets through adapters embedded in this Actor; it does not submit applications or access private employer data.
Found a bug or need a custom variant (a different ATS, a market-wide board once one of this factory's job-board Actors ships)? Open an issue on the Actor page.
Commercial guide: Hiring Trend Index — Stateful Function-Level Change Monitor
Track comparable public hiring slices over time and receive explicit baselines, before/after counts, function changes, materiality, confidence, and retry-safe advisories.
This guide is written for buyers, operators, analysts, and automation builders. It explains what the Actor observes, how to turn the Dataset into a controlled workflow, and where human verification remains mandatory.
The decision this product supports
What materially changed in the same supported hiring slice since the previous valid observation, and how reliable is that comparison?
The Actor reduces collection and first-pass triage work. It does not remove responsibility for source verification or authorize an external business action. The commercial value comes from a structured, repeatable evidence layer: stable identity, observation time, source evidence, confidence, gaps, recommended action, and failure semantics travel with the raw facts.
Who uses it
| User | Value |
|---|---|
| B2B marketers | Review verified hiring expansion or contraction as one contextual account signal. |
| Founder-led sales teams | Watch a small strategic account set without manually comparing job-board counts. |
| Competitive intelligence teams | Track function mix changes with explicit before/after evidence. |
| Recruiting analysts | Observe public role-count movement across supported company boards or market slices. |
| RevOps teams | Send material, high-confidence events into an analyst queue while keeping first runs and failures out. |
| Automation builders | Use eventId, baseline semantics, change flags, materiality, and source failure handling. |
Input contract
| Input field | How to use it |
|---|---|
| slices | Required list of 1–10 company or supported board slice identifiers. The exact slice string defines the observed entity. |
| watch_key | State namespace for this watch set. Reuse it for comparisons; use a different key for an independent baseline. |
| new_window_days | Company-slice lookback used by the underlying current-role signal. It does not affect board slices. |
Recommended first Input
{"slices": ["company:greenhouse:gitlab","company:greenhouse:stripe"],"watch_key": "my-hiring-watch","new_window_days": 30}
Start with this bounded example, inspect every Dataset field, and only then expand the scope. Input limits are product controls, not inconveniences: they make cost, completeness, and error handling visible.
Field dictionary
| Field or group | Meaning |
|---|---|
| entityId, eventId, slice, inputRef | Stable watched slice and observation-event identity. |
| firstSeenAt, previousObservedAt, lastSeenAt, observedAt | Baseline and current observation boundaries. |
| before, after, totalOpenRolesDelta, changeMagnitude | Comparable total and function-level state before and after. |
| trend, byFunction, growingFunctions, shrinkingFunctions | Normalized function mix and observed directions. |
| changeFlags, materialityScore, materialityBand, materialityReasons | Deterministic change classification separate from evidence confidence. |
| baselineCreated | True on first observation; no prior trend is fabricated. |
| partial, missingSlices, sourceEvidence | Coverage and current normalized source counts. |
| confidenceScore, confidenceBand, confidenceRisks | Support for the comparison after baseline, source, and partial checks. |
| recommendedAction, actionPriority, safeToAutomate | Human-review routing for expansion, contraction, flat, first, and failed observations. |
| failureType, retryable, recommendation | Handling for partial source, baseline error, budget, source failure, or unresolved slice. |
Common decision fields
| Field | Operational meaning |
|---|---|
| recordType | The semantic row family. Use it to distinguish a business result from an advisory or terminal record. |
| schemaVersion | Version of the additive decision-intelligence contract. Pin or validate it in strict consumers. |
| entityId | Stable entity identity for deduplication and joins. It is not necessarily a legal identifier. |
| inputRef | The relevant submitted input reference after normalization. |
| observedAt | When the Actor observed or finalized the evidence. It is not necessarily the source publication time. |
| firstSeenAt and lastSeenAt | Always-emitted observation boundaries. Stateful monitors use the compatible baseline/current boundary. Stateless rows set both equal to observedAt for the current run; that equality does not establish historical tenure. |
| freshness | A structured statement about evidence age or availability, not a prediction. Its basis and age unit follow the source-specific field definition. |
| eventId | For monitors, the stable identity of one observed transition or monitor outcome. It is distinct from entityId. |
| before and after | For monitors, the bounded comparable snapshots used for the decision. Null means that side of a comparison was not honestly available. |
| changedFields and changeFlags | Machine-readable monitor deltas and normalized change labels. Empty arrays mean no supported changed field was established, not that every possible real-world fact stayed constant. |
| materialityScore and materialityBand | Magnitude of an observed monitor change when the Actor can calculate it. Materiality is separate from evidence confidence and may be unknown when the source lacks the required facts. |
| confidenceScore | Evidence support on a 0–100 scale. It is separate from materiality, lead score, or business value. |
| confidenceBand | Readable high/medium/low/unknown grouping of evidence support. |
| confidenceReasons | Observed facts that raise confidence. |
| confidenceRisks | Missing, partial, ambiguous, inferred, or conflicting aspects that reduce confidence. |
| confidenceConflict | Explicit consistency warning when structured evidence does not reconcile. |
| sourceEvidence | Source-linked observations supporting the row. Preserve this during export. |
| dataGaps | Important evidence the Actor did not observe or cannot establish. Keep these gaps visible in CRM, spreadsheet, and automation exports. |
| negativeSignals | Machine-readable risks or gaps. A negative signal is not automatically a negative business outcome. |
| recommendedAction | Bounded review label produced from the available evidence. |
| actionPriority | Suggested queue priority, not urgency guaranteed by the source. |
| actionReason | Plain-language explanation for the recommended action. |
| safeToAutomate | Whether the narrow recommended action is deterministic enough for automation. Organizational policy still applies. |
| failureType | Normalized terminal or partial failure classification. Null means no classified failure. |
| retryable | Whether a later retry may legitimately change an operationally incomplete result. |
| recommendation | Human-readable handling guidance, especially for terminal rows. |
Evidence, confidence, and honest boundaries
What the evidence supports
- The first successful observation creates a baseline and never claims a trend.
- A change compares the same normalized slice/function taxonomy against the prior valid state in the same watch namespace.
- Materiality measures observed count movement; confidence measures support for that comparison.
- Partial or failed slices cannot produce a trustworthy aggregate movement claim.
- A confirmed charge and valid delivery are required before affected state advances under the runtime contract.
What this Actor never claims
- The Actor does not infer buyer intent, revenue growth, layoffs, budget, strategy, or financial health from hiring counts.
- It does not treat the initial baseline as an increase from zero.
- It does not compare different watch keys or materially different slice definitions as one continuous history.
- It does not turn a source failure into contraction or zero hiring.
- It does not claim that every listed opening will be filled or remains open after observation time.
Reading data gaps correctly
A data gap is part of the result. Nulls, partial flags, confidence risks, source failures, and unavailable fields must survive export. Removing these fields makes the remaining facts look more complete than they are. When two sources conflict or a required identity cannot be proven, lower confidence and keep safeToAutomate=false.
Source evidence is not permission
A public source proves only that a value or statement was observable at the recorded time and URL. It does not establish consent, contractual rights, legal status, accuracy after observation, or authorization for a downstream action. Your organization remains responsible for source terms, privacy rules, outreach policy, retention, and human review.
Decision policy and action routing
| Action | How to use it |
|---|---|
| SCHEDULE_NEXT_COMPARISON | Keep the same watch key and slice definition so the next valid run can create a real event. |
| PRIORITIZE_GROWTH_SIGNAL_REVIEW | Inspect the high-materiality expansion and relevant functions before using it as account context. |
| REVIEW_CONTRACTION_SIGNAL | Validate source coverage and changed functions; do not equate contraction with layoffs. |
| NO_MATERIAL_CHANGE | Record the flat observation and avoid unnecessary external action. |
| RETRY_MISSING_SLICES | Restore complete source evidence before accepting an aggregate change. |
| REVIEW_SLICE_CONFIGURATION | Correct or replace an unresolved supported-slice definition. |
| REVIEW_HIRING_CHANGE | Inspect lower-materiality movement in context. |
Confidence is not attractiveness
confidenceScore answers “how strongly does the available evidence support this factual classification?” It does not answer “how valuable is this lead, property, account, or address?” A high-confidence negative fact may be commercially uninteresting; a low-confidence positive signal may deserve research but not action. Keep the concepts separate in dashboards, exports, and CRM fields.
Why safeToAutomate is conservative
safeToAutomate is intentionally false whenever the next step could amplify an uncertain inference. It may be true only for narrow deterministic actions explicitly supported by the row, such as suppressing an email with invalid syntax. A true value does not waive legal, privacy, consent, contractual, or organizational rules.
Retry policy
- Retry when
retryable=trueand the failure is operational, such as a temporary source or DNS problem. - Do not endlessly retry deterministic invalid input, policy refusal, or confirmed absence.
- A retry must preserve the original input reference and must not create duplicate downstream actions.
- Budget exhaustion is not negative evidence about the entity. Resume only the unprocessed scope with an authorized budget.
- A failed Actor run is an operational event. Never transform it into “no listing,” “no contact,” “bad lead,” or “invalid email.”
Commercial use-case playbooks
1. Strategic account watch
Goal. Track two to ten company slices on a schedule and send only material, complete events to a researcher.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
2. Function expansion alert
Goal. Filter growing sales or marketing functions, open current source evidence, and validate business relevance manually.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
3. Competitive talent signal
Goal. Compare engineering, product, sales, and support mix over time without interpreting counts as financial statements.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
4. Agency weekly brief
Goal. Deliver before/after, materiality, confidence, and a clear limitation note instead of a raw “hiring up” headline.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
5. Baseline migration
Goal. Use a new watch key when the portfolio or definition is intentionally changed, and do not stitch incompatible histories.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
6. Partial-run quarantine
Goal. Route missingSlices and source failures away from change alerts so outages cannot look like contraction.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
7. Flat-change suppression
Goal. Keep no-material-change events in the audit history without creating unnecessary CRM tasks.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
8. Cost-controlled portfolio
Goal. Use at most ten intentional slices, review event utility, and remove low-value watches through an accountable policy.
Recommended runbook.
- Define the submitted cohort and write down why it is in scope.
- Start with the smallest useful Input and preserve the exact run ID.
- Inspect the Dataset overview before exporting anything.
- Check
failureType,retryable, completeness indicators, andconfidenceBand. - Open the relevant
sourceEvidenceor source URL for material rows. - Apply the recommended action as a review label, not as an instruction to contact, buy, delete, accuse, or publish.
- Record the analyst's final disposition in the destination system.
Do not skip. A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
Integration recipes
All examples use placeholders. Keep the Apify token in a secret manager and never write it into a Dataset, README, screenshot, or client-side application.
cURL: start a run and wait briefly
curl -sS -X POST 'https://api.apify.com/v2/acts/zinin~hiring-trend-index/runs?waitForFinish=60' \-H "Authorization: Bearer $APIFY_TOKEN" \-H 'Content-Type: application/json' \--data '{"slices":["company:greenhouse:gitlab","company:greenhouse:stripe"],"watch_key":"my-hiring-watch","new_window_days":30}'
The run response includes defaultDatasetId. Read clean JSON rows with:
curl -sS "https://api.apify.com/v2/datasets/$DEFAULT_DATASET_ID/items?clean=true&format=json" \-H "Authorization: Bearer $APIFY_TOKEN"
JavaScript with apify-client
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const input = {"slices": ["company:greenhouse:gitlab","company:greenhouse:stripe"],"watch_key": "my-hiring-watch","new_window_days": 30};const run = await client.actor('zinin/hiring-trend-index').call(input);const { items } = await client.dataset(run.defaultDatasetId).listItems({ clean: true });for (const row of items) {console.log({entityId: row.entityId,confidenceBand: row.confidenceBand,recommendedAction: row.recommendedAction,safeToAutomate: row.safeToAutomate,failureType: row.failureType,});}
Python with apify-client
import osfrom apify_client import ApifyClientclient = ApifyClient(os.environ["APIFY_TOKEN"])run = client.actor("zinin/hiring-trend-index").call(run_input={"slices": ["company:greenhouse:gitlab","company:greenhouse:stripe"],"watch_key": "my-hiring-watch","new_window_days": 30})for row in client.dataset(run["defaultDatasetId"]).iterate_items(clean=True):print({"entityId": row.get("entityId"),"confidenceBand": row.get("confidenceBand"),"recommendedAction": row.get("recommendedAction"),"safeToAutomate": row.get("safeToAutomate"),"failureType": row.get("failureType"),})
Apify MCP call
{"name": "call-actor","arguments": {"actor": "zinin/hiring-trend-index","input": {"slices": ["company:greenhouse:gitlab","company:greenhouse:stripe"],"watch_key": "my-hiring-watch","new_window_days": 30}}}
Generic webhook consumer policy
- Trigger on a terminal Actor run event.
- Confirm the run status is
SUCCEEDEDbefore reading business rows. - Retrieve rows from
defaultDatasetId. - Reject or quarantine rows whose
failureTypeis non-null unless your policy explicitly handles that failure. - Send
safeToAutomate=falserows to a human-review queue. - Store
entityId,observedAt,sourceEvidence, confidence, action, and the Apify run ID together. - Make retries idempotent by keying the destination on the stable entity ID plus the intended observation or event identity.
Where this fits in a practical stack
| Destination | Recommended pattern |
|---|---|
| Apify Console | Use the visual Input form, start the run, then open the default Dataset overview. This is the fastest path for a one-off review and the best place to inspect evidence before automating anything. |
| Apify API | POST JSON input to the Actor run endpoint, wait or poll for completion, then read the default Dataset through the URL returned by the run object. |
| JavaScript client | Use apify-client from a Node.js service, pass the same JSON object as the Console Input, and preserve the returned run and Dataset IDs in your own audit log. |
| Python client | Use apify-client in a Python enrichment job, iterate Dataset items, and route rows by recommendedAction, confidenceBand, failureType, and retryable. |
| Make | Start the Actor from a scenario, wait for the run, retrieve Dataset items, filter unsafe or low-confidence rows, then insert review-ready rows into the destination application. |
| Zapier | Use an Apify run action or webhook trigger, fetch Dataset items, apply a Filter step, and send only review-approved fields into the next sales or operations step. |
| n8n | Use HTTP Request or Apify nodes, branch on failureType and retryable, keep a manual-review lane for safeToAutomate=false, and write sourceEvidence together with the business fields. |
| Google Sheets | Export the Dataset directly or append rows from an automation. Keep stable entityId as a hidden key so reruns update the correct record instead of creating ambiguous duplicates. |
| Airtable | Map entityId to a primary or deduplication field, store confidence and evidence in separate columns, and expose recommendedAction as the triage view. |
| Webhook | Configure an Apify webhook for terminal run states, retrieve the Dataset after SUCCEEDED, and treat FAILED or TIMED-OUT runs as operational events rather than negative business evidence. |
A safe automation shape
The Actor is a collection and decision-support component. A production workflow should keep raw evidence, decision metadata, and business action in distinct layers:
- Collect: run the Actor with explicit bounded input.
- Validate: require a successful run and schema-valid Dataset rows.
- Triage: branch on
failureType,retryable,confidenceBand, andsafeToAutomate. - Review: open source evidence for rows that may affect a person, campaign, investment, compliance decision, or customer record.
- Act: execute only the action approved by your own policy and authorized operator.
- Audit: retain run ID, Dataset ID, observation time, input reference, source evidence, and the final human decision.
This separation prevents a common automation error: turning “data was observed” into “a business action is justified.”
Operating guide
Before the first production run
- Write the business question in one sentence: What materially changed in the same supported hiring slice since the previous valid observation, and how reliable is that comparison?
- Confirm every submitted input is within your authorized scope.
- Use the prefilled small example and review all returned row types.
- Map stable identifiers, confidence, evidence, actions, gaps, failure, and retry fields into the destination.
- Establish a human owner for review exceptions.
- Set a run budget and output bound appropriate to the test.
- Verify that secrets are stored only in the platform or workflow secret manager.
After every scheduled run
- Check terminal run status and logs.
- Compare the number of submitted entities, produced business rows, and advisory rows.
- Review partial, unknown, conflict, and low-confidence buckets.
- Inspect a sample of source evidence, including at least one positive and one negative result.
- Confirm the destination deduplicated on the intended stable key.
- Verify that no downstream action was triggered from an error row.
- Track cost per useful reviewed row rather than cost per raw request alone.
Production monitoring signals
Monitor source-unavailable rate, partial-row rate, low-confidence share, missing evidence, retry volume, run duration, Dataset row count, and spend. A sudden shift may indicate source drift, input drift, or an upstream outage. Stop automation and investigate before accepting a new pattern as business truth.
Cost control
Run a stable two-slice watch once to create baselines, then run it again with the same watch key. Confirm that the first run is not labeled growth and that partial sources cannot trigger a material alert. Use live Apify pricing for cost.
Use maxTotalChargeUsd when calling a monetized Actor if your workflow supports it. Treat a buyer-set cap as a hard safety boundary. If the cap stops work, the unfinished items remain unprocessed; they do not become negative results.
Review templates and quality reporting
Row-review worksheet
For every material row, an analyst should be able to answer the following without relying on memory or an unstated assumption:
- What submitted entity or query does this row refer to?
- Is it a business result, a baseline/advisory row, a partial observation, or a failure?
- Which exact source evidence supports the headline fact?
- When was the evidence observed, and is there a different source publication time?
- Which fields are direct observations, which are normalized, and which are deterministic derivations?
- What important evidence is null, missing, partial, ambiguous, or conflicting?
- Does confidence describe evidence support only, or has someone incorrectly treated it as business value?
- What recommended action is present, and what additional verification does its reason require?
- Is the narrow action marked safe to automate? If yes, does organizational policy also permit it?
- What final human disposition was made, by whom, and from which run and Dataset item?
Field-group review prompts
1. entityId, eventId, slice, inputRef
Contract meaning: Stable watched slice and observation-event identity.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
2. firstSeenAt, previousObservedAt, lastSeenAt, observedAt
Contract meaning: Baseline and current observation boundaries.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
3. before, after, totalOpenRolesDelta, changeMagnitude
Contract meaning: Comparable total and function-level state before and after.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
4. trend, byFunction, growingFunctions, shrinkingFunctions
Contract meaning: Normalized function mix and observed directions.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
5. changeFlags, materialityScore, materialityBand, materialityReasons
Contract meaning: Deterministic change classification separate from evidence confidence.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
6. baselineCreated
Contract meaning: True on first observation; no prior trend is fabricated.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
7. partial, missingSlices, sourceEvidence
Contract meaning: Coverage and current normalized source counts.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
8. confidenceScore, confidenceBand, confidenceRisks
Contract meaning: Support for the comparison after baseline, source, and partial checks.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
9. recommendedAction, actionPriority, safeToAutomate
Contract meaning: Human-review routing for expansion, contraction, flat, first, and failed observations.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
10. failureType, retryable, recommendation
Contract meaning: Handling for partial source, baseline error, budget, source failure, or unresolved slice.
Reviewer prompts: Is the value present? Does its type match the schema? Is it supported by sourceEvidence or a documented deterministic transformation? Is any null being silently converted into a default? Would the value still mean the same thing after CSV export? Does the destination preserve the related confidence and gap fields?
Weekly quality report
Create a recurring internal report with these measures. The report is about pipeline health, not market demand unless the source contract explicitly measures demand.
| Metric | Why it matters | Investigate when |
|---|---|---|
| Submitted inputs | Defines the actual denominator and scope of the run. | The count differs from the approved batch or schedule. |
| Business result rows | Shows how many usable observations were produced. | The rate changes sharply without an input explanation. |
| Advisory/failure rows | Prevents operational failures from disappearing in a results-only dashboard. | Any terminal class grows or is unmapped. |
| Partial-result rate | Measures incomplete source coverage or configured truncation. | It rises, or analysts stop seeing the partial warning. |
| Low-confidence rate | Shows the share of rows requiring more evidence. | It rises by source, cohort, or input pattern. |
| Retryable failure rate | Distinguishes temporary operational issues from deterministic outcomes. | Retries repeat without improving evidence. |
| Evidence-link coverage | Confirms material facts remain traceable after export. | Links or evidence objects are missing from delivered records. |
| Safe-automation share | Shows how little or much of the workflow can be deterministic. | A mapping change makes unsafe actions appear safe. |
| Manual-review backlog | Measures whether human verification capacity matches collection volume. | Rows age beyond the campaign or decision window. |
| Duplicate destination writes | Tests idempotency and stable identity mapping. | The same entity/run creates multiple external actions. |
| Cost per reviewed useful row | Relates platform spend to approved, decision-useful output. | Raw volume rises but reviewed utility falls. |
| Source-drift exceptions | Detects changed markup, response shape, policy, or source availability. | A new unknown pattern survives more than one bounded check. |
Client-facing delivery note template
Use a note like this when delivering exports to a client or another team:
This Dataset contains bounded public-source observations produced by the Apify Actor for the submitted Input. Each row includes observation time, evidence confidence, recommended review action, and explicit gaps where available. A positive row is not proof of buyer intent, permission, legal status, future outcome, or any fact listed in the Actor's “never claims” section. Partial and failure rows are included so coverage is not overstated. Validate material rows at their source before acting.
Add the Actor URL, run URL, Dataset URL, build/version, exact Input scope, observation window, pricing model observed for the run, reviewer name, and date of approval.
CRM disposition vocabulary
Keep collection results and sales dispositions separate. A practical downstream vocabulary is:
needs_evidence_review: useful signal exists but a reviewer has not approved it.needs_identity_review: entity or ownership association is not sufficiently proven.needs_policy_review: contact, privacy, suppression, legal, or contractual policy must be checked.approved_for_research: an analyst may perform more research; this is not approval for outreach.approved_for_authorized_action: a named operator approved one specific action under the organization's policy.retry_operational_failure: the source or infrastructure failed and a bounded retry is appropriate.closed_no_supported_signal: the completed bounded check found no supported signal; this is not a universal negative fact.closed_out_of_scope: the input should not have entered this workflow.
Never overwrite recommendedAction with the CRM disposition. The first is Actor-produced decision support; the second is your organization's accountable decision.
Sampling plan
For a new workflow, review every row in the first small run. When the contract is understood, sample all failure and partial rows plus a representative set of high-, medium-, and low-confidence results. Re-expand to full review whenever the source changes, the schema version changes, a new input cohort is introduced, the error distribution shifts, or a downstream user reports an unexplained result.
Change-management record
When you change field mappings or automation policy, record:
- Previous mapping or rule.
- New mapping or rule.
- Actor build/version and schemaVersion used for validation.
- Test run and Dataset URLs.
- Positive, negative, partial, retry, and budget fixtures inspected.
- Security and privacy review outcome.
- Approver and activation time.
- Rollback condition and responsible operator.
This makes a commercial data workflow supportable. Without the record, a later operator cannot distinguish a real source change from an undocumented mapping change.
Delivery patterns for marketing and small-business teams
One-off research
Run the Actor in Console, inspect the overview table, open evidence for each material row, and export only the approved subset. Record the run URL in the client or campaign notes.
Recurring watch or hygiene job
Use an Apify schedule. Write rows into a staging table keyed by entityId. Compare current and previous observations only when the Actor supplies valid state or your own pipeline implements an explicit comparable baseline. Never infer a change from a failed run.
Agency client delivery
Deliver three views: business results, evidence/quality exceptions, and operational failures. Include the run URL, observation time, configured scope, and a plain-language statement of what the Actor does not prove. This makes the deliverable auditable and reduces disputes caused by overclaiming.
CRM enrichment
Write into staging fields first. A human or approved policy promotes values into canonical CRM fields. Keep raw source values separate from normalized and decision fields, and do not replace a verified value with a lower-confidence observation.
AI-assisted review
An LLM can summarize rows, but it must receive the evidence, confidence risks, negative signals, and limitations. Require citations to sourceEvidence and prohibit invented identity, intent, legal, funding, mailbox, valuation, or availability facts.
Buyer and operator acceptance checklist
Use this checklist before calling the workflow production-ready.
Product fit
- The business question matches: What materially changed in the same supported hiring slice since the previous valid observation, and how reliable is that comparison?
- The submitted entities were selected through an authorized process.
- A human owner understands the positive, negative, partial, and failure row types.
- The team accepts the boundaries listed in “What this Actor never claims.”
- The destination keeps evidence confidence separate from business scoring.
Input and run controls
-
slicesis explicitly reviewed and bounded. -
watch_keyis explicitly reviewed and bounded. -
new_window_daysis explicitly reviewed and bounded. - The first production-like run uses a small representative sample.
- A maximum charge or internal spend alert is configured where appropriate.
- The workflow records Actor ID, build/version, run ID, Dataset ID, and input hash.
Data handling
-
entityIdis mapped to an idempotent destination key. -
observedAtand source-specific time fields remain distinct. -
sourceEvidence, gaps, and nulls are preserved. - Advisory and failure rows cannot enter the positive-results lane.
- Low-confidence and partial rows have a visible manual-review view.
- Retention and deletion rules match the type of data collected.
Action safety
-
recommendedActionis treated as a review label. -
safeToAutomate=falseblocks automatic external action. - Consent, suppression, legal, contractual, and platform rules are evaluated downstream.
- A reviewer can trace a material action back to source evidence and run metadata.
- Retry logic cannot duplicate a downstream action.
Ongoing quality
- The team monitors failure, retry, partial, low-confidence, and empty-result rates.
- A source-drift threshold pauses the workflow for inspection.
- Sample evidence is manually reviewed on a recurring basis.
- Cost per useful reviewed row is measured.
- Documentation and field mappings are updated when schemaVersion changes.
Frequently asked questions
Is this a database?
No. It is an on-demand observation tool. Each run collects or evaluates the submitted scope and records evidence at that time.
Does a found row prove commercial interest?
No. A found row proves only the factual observation described by its fields. Buyer intent is never inferred.
Can I automatically contact every result?
No. Use recommendedAction as triage, verify the evidence and identity, and apply your own consent, privacy, suppression, and outreach rules.
Why is safeToAutomate often false?
Because a useful observation can still require identity, context, legal, or source verification before action. Conservative routing prevents false certainty from scaling.
What should I do with low confidence?
Open confidenceRisks and sourceEvidence, close the important gap, or keep the row in a manual queue. Do not hide the confidence field.
What does partial mean?
The Actor obtained some usable evidence but could not support a complete observation of the configured scope. Partial is not the same as empty.
What is a confirmed zero?
Only an explicit source or deterministic rule can support a confirmed absence. An outage, truncation, or unreadable response is not a zero.
Should I retry every failure?
No. Retry only when retryable is true. Invalid input, policy refusal, or deterministic classification should be corrected or handled, not looped.
Can I delete failure rows?
You can exclude them from a business-results view, but retain them in operational logs so Dataset completeness and retry decisions stay explainable.
How should I deduplicate?
Use entityId for the entity and, for stateful monitors, eventId for the observed transition. Also retain the Apify run ID.
Can I treat confidence as conversion probability?
No. Confidence measures evidence support, not purchase probability, revenue, suitability, or expected return.
Can I change the recommended action?
Yes. It is an explainable default. Your downstream policy can be stricter, and should encode organization-specific authorization and risk tolerance.
How do I estimate cost?
Run the smallest representative input, inspect live event prices and run usage in Apify, then model the number of billable result events. The live pricing panel is authoritative.
Why use a small prefill?
It produces a cheap, fast, inspectable first run and reduces the chance of scaling a wrong input or workflow assumption.
Can I schedule it?
Yes. Use an Apify schedule, but make the destination idempotent and review changes in failure, partial, and confidence rates.
Can I export CSV or Excel?
Yes. Apify Datasets support common export formats. JSON is recommended when you need nested evidence and decision fields.
Can I send results to Sheets or Airtable?
Yes. Preserve entityId, confidence, evidence, gaps, actions, and failure fields instead of mapping only the headline value.
Can I use it from Make, Zapier, or n8n?
Yes. Start the Actor, wait for a successful terminal state, read Dataset items, then branch on decision and failure fields.
Can an LLM consume the output?
Yes, but pass the structured evidence and limitations together. Instruct the model not to invent missing facts and to cite sourceEvidence.
What happens when a source changes?
The run may become partial, unavailable, or fail validation. Monitor these rates and inspect logs before treating changed output as a real-world shift.
Does public mean unrestricted?
No. Public visibility does not remove source terms, privacy obligations, retention rules, or the need for a legitimate downstream purpose.
Is a source URL permanent?
Not necessarily. Store observation time and material facts because web content can change or disappear.
Can I rely on one row for a high-stakes decision?
No. High-stakes legal, financial, employment, compliance, safety, or personal decisions require appropriate primary evidence and qualified review.
How do I report a suspected parsing issue?
Provide the Actor run ID, a redacted input, affected field, expected source evidence, and whether the issue reproduces. Never include tokens or private data.
What does success mean?
A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.
Support information to include with an issue
Provide the public Actor name, Apify run ID, Dataset item index or stable entity ID, a redacted Input, the relevant source URL, expected behavior, observed behavior, and whether retrying produced the same result. Do not include an Apify token, API key, private customer record, or unnecessary personal data.
Final interpretation rule
A change event proves comparable public role-count movement in the configured slice. It remains contextual evidence, not buyer intent, strategy, revenue, or employment-action proof.