{ "openapi": "3.0.1", "info": { "title": "Ashby Jobs API: Open Jobs + Compensation from Any Ashby Board", "description": "Every open job from any Ashby board (jobs.ashbyhq.com) via the official public Job Postings API, with full compensation tiers (salary, equity, bonus), department, team, workplace type and all locations. Filters, only-new mode. $1 per 1,000 jobs.", "version": "1.1", "x-build-id": "ER70rZV8NgF9P0A3B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/globose_talent_mn9~ashby-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-globose_talent_mn9-ashby-jobs-api", "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/globose_talent_mn9~ashby-jobs-api/runs": { "post": { "operationId": "runs-sync-globose_talent_mn9-ashby-jobs-api", "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/globose_talent_mn9~ashby-jobs-api/run-sync": { "post": { "operationId": "run-sync-globose_talent_mn9-ashby-jobs-api", "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": "Ashby boards", "type": "array", "description": "One per line: a Ashby board URL (https://jobs.ashbyhq.com/ramp), or just the board slug (the part after the domain), e.g. 'notion'. Boards on other ATSs are rejected with a free error row; use the multi-ATS Company Jobs API Actor for those.", "items": { "type": "string" } }, "keywords": { "title": "Title keywords (any)", "type": "array", "description": "Keep jobs whose title contains any of these (case-insensitive), e.g. 'engineer', 'product manager'. Empty = all.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Drop jobs whose title contains any of these, e.g. 'intern', 'senior'.", "items": { "type": "string" } }, "locations": { "title": "Locations (any)", "type": "array", "description": "Keep jobs whose location, any secondary location or country contains one of these, e.g. 'London', 'United States', 'Remote'.", "items": { "type": "string" } }, "departments": { "title": "Departments (any)", "type": "array", "description": "Keep jobs whose department contains one of these, e.g. 'Engineering', 'Sales'. See SUMMARY in the key-value store for each board's department counts.", "items": { "type": "string" } }, "teams": { "title": "Teams (any)", "type": "array", "description": "Keep jobs whose team contains one of these, e.g. 'Backend', 'Infrastructure'.", "items": { "type": "string" } }, "employmentTypes": { "title": "Employment types (any)", "type": "array", "description": "Ashby employment type: FullTime, PartTime, Intern, Contract, Temporary.", "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace types (any)", "type": "array", "description": "Ashby workplace type: 'Remote', 'Hybrid', 'OnSite'.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs flagged as remote (by the ATS, or with 'Remote' in a location).", "default": false }, "postedWithinDays": { "title": "Posted/updated within (days)", "minimum": 0, "type": "integer", "description": "Keep jobs posted or updated in the last N days. 0 = any time.", "default": 0 }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only jobs that publish a salary range (from the ATS or the description text).", "default": false }, "minAnnualSalary": { "title": "Minimum annual salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose top of range, annualized (hourly x2080, monthly x12), is at least this. Jobs without a salary are kept unless 'Only jobs with a salary' is on. Currency is not converted. 0 = off.", "default": 0 }, "onlyNew": { "title": "Only new jobs since my last run", "type": "boolean", "description": "Remember job IDs between runs (in a named key-value store in your account) and return only jobs not seen before. Ideal for scheduled monitoring and alerts.", "default": false }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Include the full description as plain text and HTML. Turn off for smaller output.", "default": true }, "redactContacts": { "title": "Redact emails and phone numbers", "type": "boolean", "description": "Replace email addresses and phone numbers inside descriptions with [redacted].", "default": true }, "maxJobsPerCompany": { "title": "Max jobs per board", "minimum": 0, "type": "integer", "description": "0 = no limit.", "default": 0 }, "maxJobsTotal": { "title": "Max jobs in total", "minimum": 0, "type": "integer", "description": "Stop after this many jobs. 0 = no limit.", "default": 0 } } }, "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 } } } } } } } } } }