{
  "openapi": "3.0.1",
  "info": {
    "title": "Hiring Signals API: Companies Hiring for Any Role Right Now",
    "description": "Find the companies hiring for a role right now: one row per company with matching open jobs, remote jobs, newest posting and countries. From 26,000 employer career sites, refreshed nightly, agencies excluded. For sales prospecting, recruiting and market research.",
    "version": "0.1",
    "x-build-id": "eHDeDGkUvbNk3dp9o"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/makerio~hiring-signals/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-makerio-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/makerio~hiring-signals/runs": {
      "post": {
        "operationId": "runs-sync-makerio-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/makerio~hiring-signals/run-sync": {
      "post": {
        "operationId": "run-sync-makerio-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": {
          "searchText": {
            "title": "Job title or keyword",
            "type": "string",
            "description": "Job title or keyword the companies are hiring for, for example \"account executive\", \"data engineer\" or \"registered nurse\". It must appear in the job title. Leave it empty and set \"postedWithinDays\" to get every new job (a daily feed)."
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Optional. Keep jobs in any of these places, checked against every location of the job. Use a city, region or country name (\"Berlin\", \"California\", \"United States\"), a two-letter country code (\"US\") or \"Remote\". Leave empty for jobs worldwide. Jobs whose location is only a site name without a city or country (for example \"Katy Hospital\") are left out when this is set.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Keep only jobs the company marks as remote, or with \"remote\" in the location.",
            "default": false
          },
          "postedWithinDays": {
            "title": "Posted within the last N days",
            "minimum": 1,
            "type": "integer",
            "description": "Optional. Keep only jobs published in the last N days, for example 1 for today and yesterday or 7 for the past week. Leave empty for any age; results are always sorted newest first."
          },
          "maxCompanies": {
            "title": "Max companies",
            "minimum": 1,
            "type": "integer",
            "description": "Return at most this many companies, the ones with the most matching jobs first. Each company returned costs $0.005, so this also caps the cost: 100 companies cost $0.01 + $0.50.",
            "default": 100
          },
          "minJobs": {
            "title": "Minimum matching jobs per company",
            "minimum": 1,
            "type": "integer",
            "description": "Leave out companies with fewer matching jobs than this. 3 or more finds companies hiring a team, not filling one seat.",
            "default": 1
          },
          "sortBy": {
            "title": "Sort companies by",
            "enum": [
              "matching",
              "recent"
            ],
            "type": "string",
            "description": "Order of the companies: by all matching open jobs, or by the ones posted in the last 7 days (who is hiring right now).",
            "default": "matching"
          },
          "ats": {
            "title": "Career site platforms",
            "type": "array",
            "description": "Search only these platforms. Leave empty to search all of them.",
            "items": {
              "type": "string",
              "enum": [
                "workday",
                "greenhouse",
                "lever",
                "ashby",
                "smartrecruiters",
                "workable",
                "recruitee",
                "personio",
                "bamboohr",
                "teamtailor",
                "rippling",
                "gem",
                "paylocity",
                "breezy",
                "oracle"
              ],
              "enumTitles": [
                "Workday",
                "Greenhouse",
                "Lever",
                "Ashby",
                "SmartRecruiters",
                "Workable",
                "Recruitee",
                "Personio",
                "BambooHR",
                "Teamtailor",
                "Rippling",
                "Gem",
                "Paylocity",
                "Breezy HR",
                "Oracle Recruiting Cloud"
              ]
            }
          },
          "companies": {
            "title": "Only these companies",
            "type": "array",
            "description": "Optional. Search only these companies instead of every known career site: company names, careers page URLs or job board URLs from any of the supported platforms, including SAP SuccessFactors career sites on a company's own domain such as careers.ey.com. Answered from last night's database in seconds; leave \"searchText\" empty to get every open job of these companies.",
            "items": {
              "type": "string"
            }
          },
          "excludeTitleKeywords": {
            "title": "Job title does not contain",
            "type": "array",
            "description": "Drop jobs whose title contains any of these words or phrases, for example \"intern\" or \"director\".",
            "items": {
              "type": "string"
            }
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Keep only these employment types.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "contract",
                "temporary",
                "internship"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contract",
                "Temporary",
                "Internship"
              ]
            }
          },
          "excludeAgencies": {
            "title": "Employers only (no staffing agencies)",
            "type": "boolean",
            "description": "Leave out staffing and recruiting agencies, job marketplaces and freelance gig platforms: their postings are often reposts or always-open pools, some years old.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}