{ "openapi": "3.0.1", "info": { "title": "Hiring Signals: Who Is Hiring in Your Niche", "description": "Returns one row per company with its open roles that match your niche keywords, new roles in the last N days, change since the last run and a 0 to 100 hiring score. Reads Workday, Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee career pages.", "version": "0.0", "x-build-id": "FT6pYvh55ZiExTG4c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brightknot~hiring-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brightknot-hiring-signals", "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/brightknot~hiring-signals/runs": { "post": { "operationId": "runs-sync-brightknot-hiring-signals", "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/brightknot~hiring-signals/run-sync": { "post": { "operationId": "run-sync-brightknot-hiring-signals", "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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "Companies to check, one per item. Use a careers page URL (https://boards.greenhouse.io/airbnb, https://jobs.lever.co/palantir, https://jobs.ashbyhq.com/ramp, https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite), 'ats:slug' (lever:palantir, workday:nvidia/wd5/NVIDIAExternalCareerSite) or a company name to auto-detect the ATS. Workday needs the careers URL.", "items": { "type": "string" } }, "keywords": { "title": "Niche keywords", "type": "array", "description": "Words that define your niche, e.g. security, salesforce, data engineer. A role matches when any of them appears as a whole word in its title, department or team (plurals match too, so 'engineer' also finds 'Engineers'). Leave empty to count every open role.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title words", "type": "array", "description": "Roles whose title contains any of these words are not counted, e.g. intern, recruiter.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Only count roles in these countries. 2-letter codes, e.g. US, GB, AE. Add REMOTE to also count remote roles anywhere. Leave empty for all countries.", "items": { "type": "string" } }, "matchDescription": { "title": "Also match keywords in job descriptions", "type": "boolean", "description": "Count a role when a keyword appears in its description, not only its title. Finds roles that use a tool (e.g. Salesforce) without naming it in the title. Slower on Workday, where each job page is read separately. SmartRecruiters lists have no descriptions, so this has no effect there.", "default": false }, "lookbackDays": { "title": "Lookback window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Matching roles posted within this many days count as new. Feeds new_matching_roles_in_lookback and the recency part of the score.", "default": 30 }, "minOpenRoles": { "title": "Minimum matching roles", "minimum": 0, "type": "integer", "description": "Companies with fewer matching open roles are left out of the results and are not charged. Set 0 to get a row for every company that was found.", "default": 1 }, "monitorMode": { "title": "Monitor mode: compare with the last run", "type": "boolean", "description": "Remembers each company's matching role count between runs and reports the change. The growth part of the score needs this. Schedule it weekly to track who is ramping up. Rows are returned either way.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps a separate memory for each list or schedule. Use a different name for each watch list. If you change the keywords or countries under the same name, growth starts again from the next run.", "default": "default" }, "maxJobsPerCompany": { "title": "Max jobs read per company", "minimum": 0, "type": "integer", "description": "Read at most this many jobs from each company's board. 0 means all. Workday boards show at most 2,000 jobs. Counts are based on the jobs read.", "default": 0 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests to run at the same time across all companies.", "default": 8 } } }, "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 } } } } } } } } } }