{
  "openapi": "3.0.1",
  "info": {
    "title": "SmartRecruiters Jobs API: Search 190k+ Jobs from 800+ Companies",
    "description": "Search 190,000+ open jobs from 800+ companies hiring on SmartRecruiters by title, place, remote and date. No board URLs. JSON, refreshed daily.",
    "version": "0.1",
    "x-build-id": "OC7fHlW0KYrbnHcOS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dododata~smartrecruiters-jobs-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dododata-smartrecruiters-jobs-api",
        "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/dododata~smartrecruiters-jobs-api/runs": {
      "post": {
        "operationId": "runs-sync-dododata-smartrecruiters-jobs-api",
        "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/dododata~smartrecruiters-jobs-api/run-sync": {
      "post": {
        "operationId": "run-sync-dododata-smartrecruiters-jobs-api",
        "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": "Title keywords",
            "type": "array",
            "description": "Keep SmartRecruiters jobs whose title has a word starting with one of these (\"engineer\" also finds \"Engineering Manager\"). Empty for every job.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude title words",
            "type": "array",
            "description": "Drop jobs whose title contains one of these whole words, for example senior or intern.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Keep jobs whose location, country or workplace type contains one of these whole words: berlin, united kingdom, us, remote. \"united kingdom\" also tries UK, Great Britain, England, Scotland, Wales and Northern Ireland, and the word Wales also matches New South Wales in Australia.",
            "items": {
              "type": "string"
            }
          },
          "excludeLocations": {
            "title": "Exclude locations",
            "type": "array",
            "description": "Drop jobs whose location, country or workplace type names one of these places, by the same rule as Locations: \"uk\" also drops \"United Kingdom\", \"remote\" drops jobs marked remote.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote only",
            "type": "boolean",
            "description": "Keep only jobs the employer marks as remote (about 4 SmartRecruiters jobs in 100).",
            "default": false
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "type": "integer",
            "description": "Keep jobs published in the last N days. With Time range also set, the narrower window wins. Empty for any date."
          },
          "timeRange": {
            "title": "Time range",
            "enum": [
              "",
              "24h",
              "3d",
              "7d",
              "30d"
            ],
            "type": "string",
            "description": "SmartRecruiters jobs published in this window (or first seen by the index when a job carries no date). The index refreshes daily; for a daily feed use Last 3 days and keep ids you have not seen, since some boards date a job before our refresh reads it.",
            "default": ""
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "Keep jobs from these companies only, by the whole company name or the SmartRecruiters company identifier (the part of the board URL after jobs.smartrecruiters.com/). Part of a name finds nothing: Bosch Group or boschgroup, not Bosch.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Drop jobs from these companies, by the whole company name or the SmartRecruiters company identifier.",
            "items": {
              "type": "string"
            }
          },
          "onlyWithSalary": {
            "title": "Only jobs with a pay range",
            "type": "boolean",
            "description": "Keep only jobs that state a pay range. SmartRecruiters job lists carry no pay, so each matching job's own record is read, newest first, until Max rows jobs with pay are found: pay comes from the employer's pay field on that record or, failing that, from the job text. Jobs without pay are left out and not charged. Most jobs state no pay, and about 4 x Max rows (at least 200) jobs without pay are read at most, so a narrow search can return fewer than Max rows: the run log says when it stopped. On 12 November 2026, data jobs worldwide: 113 with pay of 525 read; in the US: 78 of 146.",
            "default": false
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Keep jobs whose employment type contains one of these: full-time, part-time, contract, intern, casual. SmartRecruiters employers pick the type from a fixed list, and almost every job states one.",
            "items": {
              "type": "string"
            }
          },
          "seniority": {
            "title": "Seniority (as the title states it)",
            "type": "array",
            "description": "Keep jobs whose title states one of these levels: \"Senior Data Engineer\" is senior, \"Staff Engineer\" lead, \"Head of Sales\" director. Read from the title words only, never guessed; most titles state no level, which \"No level in the title\" keeps.",
            "items": {
              "type": "string",
              "enum": [
                "intern",
                "junior",
                "senior",
                "lead",
                "director",
                "unspecified"
              ],
              "enumTitles": [
                "Intern, working student, apprentice",
                "Junior, graduate, entry level",
                "Senior",
                "Staff, principal, lead",
                "Director, VP, head of, chief",
                "No level in the title"
              ]
            }
          },
          "workplaceTypes": {
            "title": "Workplace type",
            "type": "array",
            "description": "Keep jobs the employer marks as remote or hybrid. SmartRecruiters marks a job remote or hybrid, or says nothing (most jobs), never on-site, so there is no on-site choice here.",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid"
              ]
            }
          },
          "maxPerCompany": {
            "title": "Max jobs per company",
            "minimum": 0,
            "type": "integer",
            "description": "At most this many jobs from one company while other companies also match, so a few very large employers (one lists over 20,000 jobs) cannot fill a search. The form starts at 5. Empty: a tenth of Max rows, at least 2. 0: no limit, and the rows are then strictly the newest matching jobs; with a limit they are the newest of each company. Not applied when you name companies."
          },
          "includeDescription": {
            "title": "Include full descriptions",
            "type": "boolean",
            "description": "Fetch the full job text for the jobs returned, live from each SmartRecruiters board. Turn off for faster, lighter rows.",
            "default": true
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Newest first, up to 5,000 per run; it is also your spend cap. The form starts at 100; a call through the API or an AI agent that leaves it out gets 20.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}