{
  "openapi": "3.0.1",
  "info": {
    "title": "Ashby Jobs Scraper: One Board You Name, No API Key",
    "description": "Give it an Ashby board token or careers URL and get that company's open roles, live from the source. No key, no login, no cookies. Do not know the company yet? Ashby Jobs API searches every Ashby boar",
    "version": "0.1",
    "x-build-id": "2psPQWtz3D6MoeK0m"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/glitchbound~ashby-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-glitchbound-ashby-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/glitchbound~ashby-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-glitchbound-ashby-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/glitchbound~ashby-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-glitchbound-ashby-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": {
          "companies": {
            "title": "Companies",
            "uniqueItems": true,
            "type": "array",
            "description": "Company domains or names, one per line, e.g. openai.com. The Actor derives the likely ashby board token and verifies it against the live API before reading it, so you do not need to know the token.",
            "items": {
              "type": "string"
            }
          },
          "boards": {
            "title": "ashby board tokens",
            "uniqueItems": true,
            "type": "array",
            "description": "Board tokens to read, one per line, e.g. openai. A platform:token form is also accepted and the platform is ignored.",
            "items": {
              "type": "string"
            }
          },
          "titleKeywords": {
            "title": "Title must contain",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only roles whose title contains any of these, one per line, e.g. security or staff engineer. Matched as plain text, case-insensitive, so c++ and node.js mean exactly that. A keyword of two or three letters (AI, RN, IT) is matched as a word, so AI no longer keeps Retail or Maintenance, and a role written short or long is matched both ways: registered nurse also keeps RN, senior also keeps Sr. A keyword that starts or ends with remote (remote software engineer) means that role, remote only. Filtered rows are not charged.",
            "items": {
              "type": "string"
            }
          },
          "titleExclude": {
            "title": "Job title must NOT contain",
            "uniqueItems": true,
            "type": "array",
            "description": "Drop roles whose title contains any of these words, one per line, e.g. senior or intern. Whole words, case-insensitive: intern drops Intern and Interns, not International. End a word with * for every word it begins (intern* also drops Internship). A role written short or long is dropped both ways: senior also drops Sr. Dropped roles are never returned and never charged.",
            "items": {
              "type": "string"
            }
          },
          "locationKeywords": {
            "title": "Location must contain",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only roles whose location contains any of these, one per line, e.g. London or Israel. A country can be written the short way (USA, US, U.S., UK) and is matched as that country, including jobs whose location names only a city. So can a US state, city or area (CA, Texas, Austin, TX, NYC, Bay Area): CA is California, not every place with \"ca\" in it. A region (Europe, EMEA, APAC, LATAM, DACH) means its countries, and Remote with a place (Remote, US) means remote jobs there. Filtered rows are not charged.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote roles only",
            "type": "boolean",
            "description": "Keep only roles flagged remote by the ATS, or whose title or location says remote or anywhere.",
            "default": false
          },
          "postedAfter": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Only jobs posted on or after this day. An ISO date (2026-11-01), or a window counted back from each run (24h, 7d, 30 days, or a number of days), so a daily schedule keeps returning just the new postings. Counted in whole days, UTC. Jobs whose board publishes no posting date are left out while this is set. Workday says only \"Posted 30+ Days Ago\" for older jobs, so those have a date only with Fetch full job details on."
          },
          "trackNewJobs": {
            "title": "Mark jobs that are new since your last run",
            "type": "boolean",
            "description": "Every row says whether your account already received that job from an earlier run of the same careers site: newSinceLastRun (true or false) and firstSeenAt (the day you first got it). The history is kept in a key-value store in your own account (ashby-jobs-seen). Schedule the run daily and the new jobs are the rows marked true. Changes no row count and no price.",
            "default": true
          },
          "onlyNewJobs": {
            "title": "Only jobs new since your last run",
            "type": "boolean",
            "description": "Return only the jobs no earlier run of the same careers site sent you; the rest are left out and not charged. The first run of a site records the starting point and returns nothing, with a note saying so. New means new to you: a job past an earlier run's limits or filters counts as new the first time it is sent.",
            "default": false
          },
          "includeDescription": {
            "title": "Include the full job description",
            "type": "boolean",
            "description": "Fetch the description text as well. Off by default because it is expensive at the source rather than here: Greenhouse returns 111 KB for a board without it and 1.97 MB with, an 18x difference for the same jobs. Rippling's board API returns no description at any setting.",
            "default": false
          },
          "maxResultsPerCompany": {
            "title": "Max results per careers site",
            "minimum": 1,
            "type": "integer",
            "description": "Ceiling on roles taken from any single board. A company with several sites (FedEx, Brink's) gets this many from each; maxItems caps the whole run.",
            "default": 1000
          },
          "maxItems": {
            "title": "Maximum results (whole run)",
            "minimum": 0,
            "type": "integer",
            "description": "A hard ceiling on rows for the entire run, across every company. The per-company limit above caps each one separately, so fifty companies at a thousand each is still fifty thousand rows; this caps the total. The run stops cleanly when it is reached and nothing beyond that point is fetched or charged. Leave empty for no ceiling."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy settings. Every source here is a public API a company publishes on purpose so its openings get indexed, and none of them block datacenter addresses, so the default is fine.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}