{
  "openapi": "3.0.3",
  "info": {
    "title": "Company Jobs API (Greenhouse, Lever, Ashby, Workable)",
    "version": "1.0.0",
    "description": "Open jobs from company career pages across six applicant tracking systems in one normalized schema. Responses are JSON {count, limit, results[], request_id}; errors are {error:{code,message,param?},request_id}. Requests are capped per call and time out after 25 seconds. Try it without a key at https://api.impakt.dev. Demo calls are capped at 5 per address per day and $0.50 for everyone per UTC day."
  },
  "servers": [
    {
      "url": "https://api.impakt.dev",
      "description": "Public API at https://api.impakt.dev."
    }
  ],
  "tags": [
    {
      "name": "Jobs"
    }
  ],
  "paths": {
    "/jobs": {
      "get": {
        "operationId": "getJobs",
        "tags": [
          "Jobs"
        ],
        "summary": "Open jobs from company career pages",
        "description": "Reads the public job boards of Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee and returns normalized jobs (newest first). Up to 5 companies and 10 jobs per call (use keyword, location and remote filters to narrow).",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": true,
            "description": "Comma-separated board slugs or careers URLs (max 5), e.g. \"airbnb,stripe\". Plain slugs require \"ats\". You can also pass ATS-prefixed values such as ashby:ramp, or a career-page URL, without \"ats\".",
            "schema": {
              "type": "string"
            },
            "example": "ramp"
          },
          {
            "name": "ats",
            "in": "query",
            "required": false,
            "description": "Required when company values are plain slugs (e.g. ramp). Not needed for ashby:ramp or a career-page URL.",
            "schema": {
              "type": "string",
              "enum": [
                "greenhouse",
                "lever",
                "ashby",
                "workable",
                "smartrecruiters",
                "recruitee"
              ]
            },
            "example": "ashby"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "Comma-separated; keep jobs whose title, department or team contains any (max 10).",
            "schema": {
              "type": "string"
            },
            "example": "engineer"
          },
          {
            "name": "exclude",
            "in": "query",
            "required": false,
            "description": "Comma-separated; drop jobs containing any of these (max 10).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "Keep only jobs whose location contains this text.",
            "schema": {
              "type": "string"
            },
            "example": "Berlin"
          },
          {
            "name": "remote",
            "in": "query",
            "required": false,
            "description": "Only jobs marked remote.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "posted_within_days",
            "in": "query",
            "required": false,
            "description": "0 disables the filter.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 365,
              "default": 0
            }
          },
          {
            "name": "include_description",
            "in": "query",
            "required": false,
            "description": "Add the job description as plain text (larger response).",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum jobs returned.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobsResponse"
                },
                "example": {
                  "count": 1,
                  "limit": 1,
                  "results": [
                    {
                      "ats": "greenhouse",
                      "companySlug": "airbnb",
                      "companyName": "Airbnb",
                      "jobId": "8376045",
                      "title": "Brand Marketing Intern, France",
                      "department": "Intern",
                      "team": null,
                      "location": "Paris, France",
                      "locations": [
                        "Paris, France"
                      ],
                      "remote": null,
                      "workplaceType": null,
                      "employmentType": null,
                      "salary": {
                        "min": 25000,
                        "max": 25000,
                        "currency": "EUR",
                        "period": "YEAR",
                        "text": "France Annual Pay Range"
                      },
                      "postedAt": "2026-11-18T17:41:29.000Z",
                      "updatedAt": "2026-11-18T17:41:29.000Z",
                      "url": "https://careers.airbnb.com/positions/8376045?gh_jid=8376045",
                      "applyUrl": "https://careers.airbnb.com/positions/8376045?gh_jid=8376045",
                      "descriptionText": "Airbnb was born in 2007 when two hosts welcomed three guests to their San Francisco home, and has since grown to over 5 million hosts who have welcomed over 2 b",
                      "scrapedAt": "2026-11-19T13:23:42.525Z"
                    }
                  ],
                  "request_id": "00000000-0000-4000-8000-000000000000"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter or body.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing or invalid marketplace secret (call through the marketplace).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "The backend rejected the input.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable or daily capacity reached. Retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took longer than 25 seconds; reduce the amount of work.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Job": {
        "type": "object",
        "properties": {
          "ats": {
            "type": "string"
          },
          "companySlug": {
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "jobId": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "department": {
            "type": "string"
          },
          "team": {
            "type": "string",
            "nullable": true
          },
          "location": {
            "type": "string"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "remote": {
            "type": "boolean",
            "nullable": true
          },
          "workplaceType": {
            "type": "string",
            "nullable": true
          },
          "employmentType": {
            "type": "string",
            "nullable": true
          },
          "salary": {
            "type": "object",
            "properties": {
              "min": {
                "type": "integer"
              },
              "max": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "period": {
                "type": "string",
                "nullable": true
              },
              "text": {
                "type": "string"
              }
            },
            "nullable": true
          },
          "postedAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string"
          },
          "applyUrl": {
            "type": "string"
          },
          "descriptionText": {
            "type": "string",
            "description": "Included only when include_description is true; omitted otherwise."
          },
          "scrapedAt": {
            "type": "string"
          }
        },
        "description": "One Job record. Fields not offered by a source are null; some fields are omitted depending on the request (see property descriptions)."
      },
      "JobsResponse": {
        "type": "object",
        "required": [
          "count",
          "limit",
          "results",
          "request_id"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "description": "Number of records returned."
          },
          "limit": {
            "type": "integer",
            "description": "Maximum records for this call."
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Job"
            }
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "example": "invalid_parameter"
              },
              "message": {
                "type": "string"
              },
              "param": {
                "type": "string"
              }
            }
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
