{
  "openapi": "3.0.1",
  "info": {
    "title": "Handshake Jobs Scraper",
    "description": "Collect anonymous public Handshake jobs by keyword, location, search URL, or job URL. Export employer, classification, compensation, dates, and full descriptions.",
    "version": "4.0",
    "x-build-id": "3hmRNpgyz39N3qiac"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~handshake-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-handshake-jobs-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/maximedupre~handshake-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-handshake-jobs-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/maximedupre~handshake-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-handshake-jobs-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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles, skills, or terms to find in public Handshake listings. Add multiple values to broaden discovery.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities, regions, countries, or other location terms to match.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "roleCategories": {
            "title": "Role categories",
            "type": "array",
            "description": "Enter the exact role category names shown on Handshake. Add one or more categories. Available categories can vary by job.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "startUrls": {
            "title": "Handshake URLs",
            "type": "array",
            "description": "Public Handshake search-result or individual job URLs. Search filters already present in a URL are preserved.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL",
                  "description": "A public Handshake search-result or individual job URL.",
                  "minLength": 1
                }
              },
              "required": [
                "url"
              ],
              "additionalProperties": false
            }
          },
          "jobIds": {
            "title": "Handshake job IDs",
            "type": "array",
            "description": "Job IDs from Handshake. Enter one ID per item to get those jobs without a search or a full job URL. Job filters also apply to these jobs.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "maxDiscoveryItems": {
            "title": "Maximum jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many matching jobs across all inputs, including direct job links. Leave unset or enter 0 to get all available matching jobs. Duplicate, filtered, and unreadable jobs do not count."
          },
          "employers": {
            "title": "Employers",
            "type": "array",
            "description": "Employer names to include. Leave empty to include jobs from any employer.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Country names to include, such as United States. Jobs must have a matching published country. Leave empty to include any country.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Employment classifications to include, such as full-time, part-time, internship, or co-op. Leave empty to include every available classification.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "workTypes": {
            "title": "Work terms",
            "type": "array",
            "description": "Include jobs whose published title or description contains at least one selected work term. Leave empty to apply no work-term filter. This filter also applies when you use keywords or job links.",
            "items": {
              "type": "string",
              "enum": [
                "contract",
                "temporary",
                "seasonal",
                "freelance"
              ],
              "enumTitles": [
                "Contract",
                "Temporary",
                "Seasonal",
                "Freelance"
              ]
            }
          },
          "workplace": {
            "title": "Workplace",
            "enum": [
              "any",
              "remote",
              "hybrid",
              "on-site"
            ],
            "type": "string",
            "description": "Include any workplace, or only jobs published as remote, hybrid, or on-site.",
            "default": "any"
          },
          "postedWithinDays": {
            "title": "Posted within",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Include jobs posted within this many days. Leave unset to include any posting date."
          },
          "compensationFilter": {
            "title": "Minimum published compensation",
            "required": [
              "amount",
              "currency",
              "cadence"
            ],
            "type": "object",
            "description": "Set a minimum for the published maximum pay. Enter an amount, currency code, and pay period. Jobs without matching pay data are left out.",
            "properties": {
              "amount": {
                "type": "number",
                "title": "Minimum amount",
                "description": "Lowest published maximum pay to include for this currency and pay period.",
                "minimum": 0
              },
              "currency": {
                "type": "string",
                "title": "Currency",
                "description": "Three-letter ISO 4217 currency code, such as USD, EUR, or GBP.",
                "pattern": "^[A-Z]{3}$",
                "minLength": 3,
                "maxLength": 3
              },
              "cadence": {
                "type": "string",
                "title": "Cadence",
                "description": "Pay period used for the minimum amount.",
                "enum": [
                  "hour",
                  "month",
                  "year"
                ],
                "enumTitles": [
                  "Per hour",
                  "Per month",
                  "Per year"
                ]
              }
            },
            "additionalProperties": false
          },
          "payPeriods": {
            "title": "Pay periods",
            "type": "array",
            "description": "Include jobs with one of these published pay periods, with no minimum pay needed. Leave empty to include all pay periods. If you also set minimum pay, both filters apply.",
            "items": {
              "type": "string",
              "enum": [
                "hour",
                "month",
                "year"
              ],
              "enumTitles": [
                "Per hour",
                "Per month",
                "Per year"
              ]
            }
          },
          "includeEmployerEmails": {
            "title": "Include employer emails",
            "type": "boolean",
            "description": "Add published employer email addresses to each job, where available. Each saved value has a separate charge. When off, none are collected, whatever the limit.",
            "default": false
          },
          "maxEmployerEmails": {
            "title": "Maximum email addresses per job",
            "minimum": 0,
            "type": "integer",
            "description": "With Include employer emails on, add up to this many email addresses per job, where available. Leave unset to use 3, or enter 0 for all available values. This limit has no effect when the switch is off.",
            "default": 3
          },
          "includeEmployerPhones": {
            "title": "Include employer phone numbers",
            "type": "boolean",
            "description": "Add published employer phone numbers to each job, where available. Each saved value has a separate charge. When off, none are collected, whatever the limit.",
            "default": false
          },
          "maxEmployerPhones": {
            "title": "Maximum phone numbers per job",
            "minimum": 0,
            "type": "integer",
            "description": "With Include employer phone numbers on, add up to this many phone numbers per job, where available. Leave unset to use 3, or enter 0 for all available values. This limit has no effect when the switch is off.",
            "default": 3
          },
          "includeEmployerSocialProfiles": {
            "title": "Include employer social profiles",
            "type": "boolean",
            "description": "Add published employer social profile links to each job, where available. Each saved value has a separate charge. When off, none are collected, whatever the limit.",
            "default": false
          },
          "maxEmployerSocialProfiles": {
            "title": "Maximum social profile links per job",
            "minimum": 0,
            "type": "integer",
            "description": "With Include employer social profiles on, add up to this many social profile links per job, where available. Leave unset to use 5, or enter 0 for all available values. This limit has no effect when the switch is off.",
            "default": 5
          },
          "includeEmployerPaymentTechnologies": {
            "title": "Include employer payment technologies",
            "type": "boolean",
            "description": "Add payment and commerce technologies named on the employer website to each job, where available. Each job with a saved technology list has a separate charge. When off, none are collected, whatever the limit.",
            "default": false
          },
          "maxEmployerPaymentTechnologies": {
            "title": "Maximum payment technologies per job",
            "minimum": 0,
            "type": "integer",
            "description": "With Include employer payment technologies on, add up to this many payment and commerce technologies per job, where available. Leave unset to use 5, or enter 0 for all available values. This limit has no effect when the switch is off.",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}