{
  "openapi": "3.0.1",
  "info": {
    "title": "HiringCafe Jobs Scraper: Salaries, Remote and Apply Links",
    "description": "Scrape HiringCafe (hiring.cafe) jobs by keyword, city and filters, or from search, company and job links: one row per job with company, salary range, remote or hybrid, seniority, posted date, apply link, skills, company facts and full description. No login.",
    "version": "0.1",
    "x-build-id": "VgRLd6pO5Gp1Ot8BN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~hiring-cafe-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-hiring-cafe-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/themineworks~hiring-cafe-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-hiring-cafe-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/themineworks~hiring-cafe-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-hiring-cafe-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": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles or keywords, one per line, as you would type them in the HiringCafe search box. Example: data analyst, registered nurse, product manager. Each keyword is one search. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Place",
            "type": "string",
            "description": "City, US ZIP code, state or country, for example New York, Austin, 94105, Texas, United Kingdom or Germany. Write \"remote\" for remote jobs anywhere. Leave empty to search every country. Used by every keyword search."
          },
          "radiusMiles": {
            "title": "Radius around a city or ZIP (miles)",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How far around a city or ZIP code to search. Leave empty for HiringCafe's default of 50 miles. Not used for states and countries."
          },
          "maxItems": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most jobs to return for each keyword or each link, 1 to 10,000. A result page holds about 40 to 110 jobs. Example: 500.",
            "default": 50
          },
          "includeDetails": {
            "title": "Open each job for the full description",
            "type": "boolean",
            "description": "On: each job's own page is read too, for the full job description. Off: rows come from the search results only (every other field is still there, including the requirements summary, skills, salary and company facts), which is about twice as fast. Same price either way.",
            "default": true
          },
          "workplaceTypes": {
            "title": "Workplace",
            "type": "array",
            "description": "Only jobs with these workplace types. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "Remote",
                "Hybrid",
                "Onsite",
                "Field"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid",
                "Onsite",
                "Field (on the road)"
              ]
            }
          },
          "employmentTypes": {
            "title": "Employment type",
            "type": "array",
            "description": "Only jobs with these employment types. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "Full Time",
                "Part Time",
                "Contract",
                "Internship",
                "Temporary",
                "Seasonal",
                "Volunteer"
              ]
            }
          },
          "seniorityLevels": {
            "title": "Seniority",
            "type": "array",
            "description": "Only jobs at these levels. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "No Prior Experience Required",
                "Entry Level",
                "Mid Level",
                "Senior Level"
              ]
            }
          },
          "roleTypes": {
            "title": "Role type",
            "type": "array",
            "description": "Individual contributor roles, people manager roles, or both (empty).",
            "items": {
              "type": "string",
              "enum": [
                "Individual Contributor",
                "People Manager"
              ]
            }
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "24h",
              "3d",
              "1w",
              "2w",
              "3w",
              "1m",
              "2m",
              "3m",
              "6m",
              "1y",
              "any"
            ],
            "type": "string",
            "description": "Only jobs posted in this window, as HiringCafe's own date filter. HiringCafe's default is 3 months.",
            "default": "3m"
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevance",
              "date",
              "salary_high",
              "salary_low",
              "experience_low"
            ],
            "type": "string",
            "description": "Order of the results.",
            "default": "relevance"
          },
          "onlyPostedSalary": {
            "title": "Only jobs with a posted salary",
            "type": "boolean",
            "description": "Only jobs where the employer published the pay range (no estimates).",
            "default": false
          },
          "visaSponsorship": {
            "title": "Only jobs that sponsor visas",
            "type": "boolean",
            "description": "Only postings that offer visa sponsorship.",
            "default": false
          },
          "relocationAssistance": {
            "title": "Only jobs with relocation help",
            "type": "boolean",
            "description": "Only postings that offer relocation assistance.",
            "default": false
          },
          "startUrls": {
            "title": "HiringCafe links (optional)",
            "type": "array",
            "description": "Links copied from hiringcafe.com or hiring.cafe: a search page with your filters (the link carries ?searchState=...), a company page such as https://hiringcafe.com/org/google.com, or single job pages such as https://hiringcafe.com/job/<id>. Pages after the first are read automatically.",
            "items": {
              "type": "string"
            }
          },
          "includeDescriptionHtml": {
            "title": "Also keep the description as HTML",
            "type": "boolean",
            "description": "Adds description_html next to description_text (details on). Off by default to keep rows small.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}