{
  "openapi": "3.0.1",
  "info": {
    "title": "Companies Hiring Now — Hiring Signals + Decision Maker Emails",
    "description": "Hiring signals for sales and recruiting: employers with open jobs for a title, from their latest postings, with company card and hiring pace over 7, 30 and 90 days, then decision makers matched to the role and recruiters, with emails on record. Agencies left out. From $1.80 per 1,000 employers.",
    "version": "0.1",
    "x-build-id": "ssalKcPGU5zEHwb38"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/b2bsearch~hiring-companies-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-b2bsearch-hiring-companies-finder",
        "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/b2bsearch~hiring-companies-finder/runs": {
      "post": {
        "operationId": "runs-sync-b2bsearch-hiring-companies-finder",
        "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/b2bsearch~hiring-companies-finder/run-sync": {
      "post": {
        "operationId": "run-sync-b2bsearch-hiring-companies-finder",
        "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": {
          "jobTitles": {
            "title": "Job titles they are hiring for",
            "maxItems": 10,
            "type": "array",
            "description": "Words the job title must contain, one query per line; an employer with a posting matching any line is kept. A line may use AND, OR, NOT, \"exact phrase\" and parentheses. Up to 10 lines.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Where the jobs are",
            "type": "array",
            "description": "Countries by name or two-letter code (United States, Germany, gb), plus US states or cities inside them. At least one country is required: employers are counted inside a country. Up to 60.",
            "items": {
              "type": "string"
            }
          },
          "maxCompanies": {
            "title": "Max employers (limited for free users)",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Stop after this many employers, most matching postings first (default 25; 0 = up to 2,000). Your spend cap: $2.40 per 1,000 employers delivered on the Free and Starter plans, $2.10 on Scale, $1.80 on Business. Free Apify plan: up to 100 per run and 500 rows per month per account.",
            "default": 25
          },
          "previewOnly": {
            "title": "Preview only: counts and breakdown, free",
            "type": "boolean",
            "description": "Returns how many employers and postings match and the breakdown by country, seniority, industry, top employers, titles and cities — no employer rows, no charge. Turn off to get the employers.",
            "default": false
          },
          "decisionMakers": {
            "title": "Add each employer's decision makers",
            "type": "boolean",
            "description": "After each employer, adds its founders, C-level, VPs and directors as separate rows: name, title, seniority, profile URL, location. $3.20 per 1,000 people delivered; employers with nobody on record are free.",
            "default": false
          },
          "decisionMakersByFunction": {
            "title": "Match decision makers to the job",
            "type": "boolean",
            "description": "Keeps the leaders of the job's own department, read from its title: a sales posting adds the revenue and sales leaders, an engineering posting the CTO and engineering heads. Each row says the department (matchedFunction). Your own keywords win; a title no department claims, or an employer with nobody in it, adds the general leadership. Same price.",
            "default": false
          },
          "decisionMakerRoles": {
            "title": "Decision maker roles",
            "uniqueItems": true,
            "type": "array",
            "description": "Which levels count as a decision maker. Rows are ordered founder + CEO first, then other founders and CEOs, the rest of the C-level, VPs, directors. Default: all four.",
            "items": {
              "type": "string",
              "enum": [
                "founder",
                "cxo",
                "vp",
                "director"
              ],
              "enumTitles": [
                "Founders and owners",
                "C-level",
                "VPs",
                "Directors"
              ]
            }
          },
          "decisionMakersPerCompany": {
            "title": "Decision makers per employer",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "How many people to add per employer, in rank order (default 3, maximum 25). Your spend cap per employer: $0.0032 per person.",
            "default": 3
          },
          "decisionMakerTitleKeywords": {
            "title": "Decision maker title keywords",
            "type": "array",
            "description": "Keep only decision makers whose job title contains any of these words — for example sales, revenue, talent (3-64 characters each, up to 10).",
            "items": {
              "type": "string"
            }
          },
          "recruiters": {
            "title": "Add the employer's recruiters",
            "type": "boolean",
            "description": "Adds the recruiters and talent partners on the employer's staff as separate rows (_type recruiter, each employer once per run): name, title, headline, profile URL, location, and the email on record. The posting names one on one row in nine; the roster fills the rest. $3.20 per 1,000 people; misses are free.",
            "default": false
          },
          "recruitersPerCompany": {
            "title": "Recruiters per employer",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "How many recruiters to add per employer, newest records and the most senior first (default 3, maximum 25). Your spend cap per employer: $0.0032 per person.",
            "default": 3
          },
          "postedLimit": {
            "title": "Hiring in the last",
            "enum": [
              "week",
              "month",
              "3months"
            ],
            "type": "string",
            "description": "Count postings from this window, from the start of the run (default last month). At most 3 months: employers are counted over every matching posting of the country.",
            "default": "month"
          },
          "postedLimitDate": {
            "title": "Hiring since",
            "type": "string",
            "description": "Count postings on or after this date (YYYY-MM-DD) instead; with the window too, the later bound wins."
          },
          "employmentType": {
            "title": "Employment type",
            "uniqueItems": true,
            "type": "array",
            "description": "Count only postings of these employment types.",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "contract",
                "internship",
                "temporary",
                "volunteer",
                "other"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contract",
                "Internship",
                "Temporary",
                "Volunteer",
                "Other"
              ]
            }
          },
          "experienceLevel": {
            "title": "Experience level",
            "uniqueItems": true,
            "type": "array",
            "description": "Count only postings at these seniority levels.",
            "items": {
              "type": "string",
              "enum": [
                "internship",
                "entry",
                "associate",
                "mid-senior",
                "director",
                "executive",
                "not-applicable"
              ],
              "enumTitles": [
                "Internship",
                "Entry level",
                "Associate",
                "Mid-Senior level",
                "Director",
                "Executive",
                "Not applicable"
              ]
            }
          },
          "industryIds": {
            "title": "Industry ids",
            "type": "array",
            "description": "Count only postings in these industries, by numeric industry id (4 for Software Development) or by industry name (Software Development). Up to 30.",
            "items": {
              "type": "string"
            }
          },
          "excludeAgencies": {
            "title": "Leave out agencies and job boards",
            "type": "boolean",
            "description": "On by default: staffing and recruiting firms and job-board aggregators are not the employers you want to call. Turn off to see them too.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}