{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Hiring Signals | Who Is Hiring by Domain API",
    "description": "Check a list of company domains and see which companies are hiring right now: open positions, job titles, career page and ATS. Reads ATS feeds (Personio, Greenhouse, Lever, Ashby…) and the company's own career page. Pay only per company with jobs found.",
    "version": "0.1",
    "x-build-id": "eXiujNMHdlwqvFBhN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/berkaydev~company-hiring-signals/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-berkaydev-company-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/berkaydev~company-hiring-signals/runs": {
      "post": {
        "operationId": "runs-sync-berkaydev-company-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/berkaydev~company-hiring-signals/run-sync": {
      "post": {
        "operationId": "run-sync-berkaydev-company-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",
        "properties": {
          "domains": {
            "title": "Company domains or websites",
            "type": "array",
            "description": "Domains or website URLs of the companies to check, e.g. delker.com or https://www.gundlach-packaging.com. One row per company comes back.",
            "items": {
              "type": "string"
            }
          },
          "datasetId": {
            "title": "Or: dataset of an earlier run",
            "type": "string",
            "description": "Chain Actors: pick or paste the dataset ID of an earlier run, for example from Google Maps Email Scraper or Company Email Finder. The website column is detected automatically. Pass it in this field (datasetId) so the Actor is allowed to read it."
          },
          "datasetField": {
            "title": "Website column in that dataset",
            "type": "string",
            "description": "Only needed if the website column is not detected automatically, e.g. companyWebsite."
          },
          "jobKeywords": {
            "title": "Only jobs containing",
            "type": "array",
            "description": "Keep only positions whose title or department contains one of these words (case-insensitive), e.g. sales, Vertrieb, Lager, engineer. A company counts as hiring only if a matching position is open.",
            "items": {
              "type": "string"
            }
          },
          "onlyHiring": {
            "title": "Only companies that are hiring",
            "type": "boolean",
            "description": "Leave out companies without open positions. They are free either way; this just keeps the table short.",
            "default": false
          },
          "onlyNewJobs": {
            "title": "Only new positions since the last run",
            "type": "boolean",
            "description": "Remembers the positions each company had in earlier runs and returns only ones that are new. Schedule it weekly to see which companies just started hiring. Only companies with new positions are charged.",
            "default": false
          },
          "checkSalary": {
            "title": "Check pay transparency",
            "type": "boolean",
            "description": "Open each job ad and record whether it states a salary (amount or range) or a collective agreement (Tarif, TVöD …), as the EU Pay Transparency Directive will require. Adds one page per job, up to maxSalaryChecksPerCompany.",
            "default": false
          },
          "maxSalaryChecksPerCompany": {
            "title": "Job ads checked for salary per company",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many job ads per company are opened when checkSalary is on.",
            "default": 10
          },
          "seenStoreName": {
            "title": "Memory name for onlyNewJobs",
            "type": "string",
            "description": "Named key-value store in your account that keeps the memory. Use a different name per company list if you track several lists.",
            "default": "hiring-signals-seen"
          },
          "maxDomains": {
            "title": "Maximum companies",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many companies (0 = all).",
            "default": 0
          },
          "maxJobsPerCompany": {
            "title": "Maximum positions listed per company",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Large employers can have hundreds of openings; this caps the list per row.",
            "default": 100
          },
          "maxPagesPerDomain": {
            "title": "Pages per website",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many career-related pages are opened per company besides the homepage.",
            "default": 4
          },
          "compact": {
            "title": "Compact rows (for AI agents)",
            "type": "boolean",
            "description": "Return only domain, hiring, jobCount, jobTitles, ats, careerPage and statusNote.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Parallel companies",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many companies are checked at the same time.",
            "default": 10
          },
          "maxRunTimeSecs": {
            "title": "Maximum run time (seconds)",
            "minimum": 60,
            "maximum": 3500,
            "type": "integer",
            "description": "The run stops cleanly before this and keeps everything found so far.",
            "default": 3000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}