{
  "openapi": "3.0.1",
  "info": {
    "title": "ATS Jobs, Salary & Hiring-Signal Intelligence (MCP)",
    "description": "Unified 6-ATS jobs, salary & hiring-signal API + MCP in Go: auto-detect Ashby, Greenhouse, Lever, SmartRecruiters, Workday & BambooHR from domains/emails, extract salaries & 80+ JD tech signals, summaries & onlyNewJobs. Independent tool, not affiliated with any ATS vendor.",
    "version": "1.1",
    "x-build-id": "cgLogqIMkyWbkzjas"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/spiky_closet~ats-jobs-hiring-intel/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-spiky_closet-ats-jobs-hiring-intel",
        "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/spiky_closet~ats-jobs-hiring-intel/runs": {
      "post": {
        "operationId": "runs-sync-spiky_closet-ats-jobs-hiring-intel",
        "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/spiky_closet~ats-jobs-hiring-intel/run-sync": {
      "post": {
        "operationId": "run-sync-spiky_closet-ats-jobs-hiring-intel",
        "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 (Domains, Emails, Career URLs, or ATS Slugs)",
            "type": "array",
            "description": "Paste company domains ('ramp.com', 'stripe.com'), work emails ('ops@anthropic.com'), career URLs, or explicit ATS slugs ('ashby:ramp', 'lever:palantir', 'smartrecruiters:BoschGroup', 'workday:nvidia:wd5:NVIDIAExternalCareerSite'). Click Start right away to test with the 3 prefilled companies.",
            "items": {
              "type": "string"
            }
          },
          "bulkCompanies": {
            "title": "Bulk Paste from CSV / Excel / Clay (Optional)",
            "type": "string",
            "description": "Paste a newline- or comma-separated list of company domains, emails, career URLs, or ATS slugs. Duplicates are removed automatically."
          },
          "summaryMode": {
            "title": "Company Hiring-Signal Summary Mode (1 Row per Company)",
            "type": "boolean",
            "description": "Emit one aggregated B2B hiring-signal summary per company (total open roles, department split, remote share, median salary, top JD tech stack, detected ATS) instead of individual job rows. Ideal for Clay, HubSpot, and VC sourcing.",
            "default": false
          },
          "onlyNewJobs": {
            "title": "Only Emit New Jobs Since Last Run (Incremental Monitor)",
            "type": "boolean",
            "description": "Tracks previously seen job IDs in a named Apify Key-Value Store and emits only newly posted roles. Previously seen jobs cost $0.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor State Store Name (for onlyNewJobs)",
            "type": "string",
            "description": "Named Apify Key-Value Store used to persist seen job IDs across scheduled runs (default: 'ats-jobs-monitor-state').",
            "default": "ats-jobs-monitor-state"
          },
          "keywords": {
            "title": "Include Keywords (Full Job Description, Title, or Department)",
            "type": "array",
            "description": "Keep only jobs matching ANY of these keywords across the title, department, or full job description (case-insensitive, e.g. ['Staff Engineer', 'Account Executive', 'AI']). Use 'Title-Only Keywords' below to match job titles exclusively. Filtered-out jobs cost $0.",
            "items": {
              "type": "string"
            }
          },
          "titleKeywords": {
            "title": "Title-Only Keywords (Matches Job Title Only)",
            "type": "array",
            "description": "Keep only jobs whose job title matches ANY of these keywords (case-insensitive, e.g. ['Staff', 'Principal', 'Founding', 'VP']). Unlike 'Include Keywords' (which searches full job descriptions), this matches job titles only. Filtered-out jobs cost $0.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude Keywords",
            "type": "array",
            "description": "Exclude jobs containing ANY of these keywords in the title or description (e.g. ['Intern', 'Contractor']).",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote Roles Only",
            "type": "boolean",
            "description": "Keep only jobs classified as remote.",
            "default": false
          },
          "departments": {
            "title": "Filter by Departments",
            "type": "array",
            "description": "Keep only jobs matching ANY listed department (e.g. ['Engineering', 'Sales', 'Product', 'Data', 'Security']).",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Filter by Locations",
            "type": "array",
            "description": "Keep only jobs whose location matches ANY listed region, city, or country (e.g. ['New York', 'San Francisco', 'London', 'United States']).",
            "items": {
              "type": "string"
            }
          },
          "minSalaryUsd": {
            "title": "Minimum Salary Floor (USD Annual)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only jobs with a parsed annualized USD salary band meeting or exceeding this floor (0 = disabled).",
            "default": 0
          },
          "mustMentionTech": {
            "title": "Must Mention Tech Stack in JD (ANY Match)",
            "type": "array",
            "description": "Keep only jobs mentioning ANY of these technologies in their job description (e.g. ['Kubernetes', 'Snowflake', 'Salesforce', 'PyTorch', 'Go']).",
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Posted Within Last N Days (0 = All Dates)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs posted within the last N days (0 = all dates).",
            "default": 0
          },
          "maxJobsPerCompany": {
            "title": "Max Jobs per Company (0 = Unlimited)",
            "minimum": 0,
            "type": "integer",
            "description": "Cap the number of matching jobs emitted per company (0 = no per-company cap; Console UI prefills 10 for fast previews while API calls remain unlimited by default).",
            "default": 0
          },
          "maxResults": {
            "title": "Max Total Results (0 = All Matching)",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on total records emitted across the run (0 = no cap; free-tier cloud runs default to 100).",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Parallel Company Concurrency (1-20)",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Number of company boards queried concurrently.",
            "default": 8
          },
          "includeDescriptionText": {
            "title": "Include Cleaned Plain-Text Job Description",
            "type": "boolean",
            "description": "Include a clean plain-text excerpt of each job description in output records.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}