{
  "openapi": "3.1.0",
  "info": {
    "title": "JobPostings API — Real-Time Enterprise ATS & Global Job Data API",
    "version": "1.0.0",
    "description": "Real-time structured job postings API across 434 ATS platforms & corporate career portals (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Rippling, BambooHR, Workable, iCIMS, and 425+ more). 9.9M+ redistribution-safe corporate & ATS jobs (`redistribution=allowed`) plus 9.9M+ attributed global listings (`include_attributed=true`). Billing: 1 Credit = 1 Job Record returned. Zero-result searches and metadata endpoints cost 0 credits.",
    "contact": {
      "name": "JobPostings API Engineering",
      "email": "contact@jobpostingsapi.com",
      "url": "https://jobpostingsapi.com"
    }
  },
  "servers": [
    {
      "url": "https://api.jobpostingsapi.com",
      "description": "Production Global Edge API Gateway"
    }
  ],
  "security": [
    {
      "ApiKeyHeader": []
    },
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "Your `jp_...` API key from https://jobpostingsapi.com/dashboard"
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Authorization: Bearer jp_..."
      }
    }
  },
  "paths": {
    "/v1/jobs/search": {
      "get": {
        "operationId": "searchJobs",
        "summary": "Search & filter active job postings across 434 ATS & career sources",
        "description": "Full-text search with multi-dimensional filters (ATS source, company, country, city, remote, salary range, skills, experience level). Costs 1 Credit per job returned (0 Credits if 0 results).",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Full-text search query (e.g., `software engineer`, `machine learning`)"
          },
          {
            "name": "title",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Job title substring filter"
          },
          {
            "name": "company",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Company name or slug filter (e.g., `stripe`, `figma`)"
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "ATS or source slug (e.g., `greenhouse`, `lever`, `ashby`, `workday`, `smartrecruiters`)"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "ISO-2 country code (e.g., `US`, `GB`, `CA`, `DE`)"
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "State or province name"
          },
          {
            "name": "city",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "City name"
          },
          {
            "name": "remote",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Filter remote-eligible positions (`true` or `false`)"
          },
          {
            "name": "employment_type",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "contract",
                "internship",
                "temporary"
              ]
            }
          },
          {
            "name": "experience_level",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "entry",
                "mid",
                "senior",
                "lead",
                "executive"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Job category (`engineering`, `data`, `ai-ml`, `product`, `design`, `devops`, `security`, `sales`)"
          },
          {
            "name": "skill",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Skill tag filter (e.g., `python`, `typescript`, `kubernetes`)"
          },
          {
            "name": "has_salary",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Only return jobs with structured salary data"
          },
          {
            "name": "salary_min",
            "in": "query",
            "schema": {
              "type": "number"
            },
            "description": "Minimum annual salary filter"
          },
          {
            "name": "posted_after",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "ISO timestamp or relative window (`24h`, `7d`, `30d`)"
          },
          {
            "name": "include_description",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Include full HTML and plain-text job description in search results"
          },
          {
            "name": "include_attributed",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Include CC-BY/attributed aggregator sources in addition to redistribution=allowed ATS jobs"
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Pagination cursor from `meta.next_cursor`"
          }
        ],
        "responses": {
          "200": {
            "description": "Normalized list of active job postings",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "id": "j_iwnoo5bdjvaf2ivy",
                      "title": "Production Supervisor $20-24 (Canton, MS)",
                      "company": {
                        "name": "Quick Hire Staffing",
                        "slug": "quick-hire-staffing",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "quickhirestaffing",
                          "job_id": "6C5E962163"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/6C5E962163",
                        "apply_url": "https://apply.workable.com/j/6C5E962163",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Canton",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MS",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": null,
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 20.0,
                        "max": 24.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "quality assurance",
                        "six sigma"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-30T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    },
                    {
                      "id": "j_qvhomvqeob3zsmzz",
                      "title": "Assistant Store Manager - Richmond Heights",
                      "company": {
                        "name": "Rebel Convenience Stores",
                        "slug": "rebel-convenience-stores",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "rebel-convenience-stores",
                          "job_id": "5004A54405"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/5004A54405",
                        "apply_url": "https://apply.workable.com/j/5004A54405",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Richmond Heights",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "OH",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": "full_time",
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 17.0,
                        "max": 17.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "customer service"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-29T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    },
                    {
                      "id": "j_6invubj6uzopeffw",
                      "title": "Python Developer",
                      "company": {
                        "name": "Tactibit Technologies",
                        "slug": "tactibit-technologies",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "jobgether",
                          "display_name": "Jobgether",
                          "type": "aggregator",
                          "board": "fn:python-developer",
                          "job_id": "6aa20861b563ea142e8ef2f3"
                        },
                        "external_id": null,
                        "url": "https://jobgether.com/offer/6aa20861b563ea142e8ef2f3-python-developer",
                        "apply_url": "https://jobgether.com/offer/6aa20861b563ea142e8ef2f3-python-developer",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": null,
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MD",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": "full_time",
                      "experience_level": null,
                      "category": null,
                      "salary": null,
                      "skills": [
                        "python"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-09-10T01:31:13Z",
                      "updated_at": null,
                      "closed_at": null
                    }
                  ],
                  "meta": {
                    "total": 14820,
                    "has_more": true,
                    "next_cursor": "20",
                    "credits_cost": 3,
                    "credits_remaining": 24997,
                    "request_id": "9f8c2a10-4b3e-4d1a-8e2f-1029384756ab"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{id}": {
      "get": {
        "operationId": "getJobById",
        "summary": "Get full job posting details & HTML/text description by ID",
        "description": "Returns complete normalized job metadata plus full `description_html` and `description_text`. Costs 1 Credit.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "j_iwnoo5bdjvaf2ivy"
          }
        ],
        "responses": {
          "200": {
            "description": "Complete job posting record",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": {
                    "id": "j_iwnoo5bdjvaf2ivy",
                    "title": "Production Supervisor $20-24 (Canton, MS)",
                    "company": {
                      "name": "Quick Hire Staffing",
                      "slug": "quick-hire-staffing",
                      "domain": null,
                      "logo_url": null
                    },
                    "source": {
                      "platform": {
                        "name": "workable",
                        "display_name": "Workable",
                        "type": "ats",
                        "board": "quickhirestaffing",
                        "job_id": "6C5E962163"
                      },
                      "external_id": null,
                      "url": "https://apply.workable.com/j/6C5E962163",
                      "apply_url": "https://apply.workable.com/j/6C5E962163",
                      "redistribution": "allowed"
                    },
                    "location": {
                      "formatted": null,
                      "city": "Canton",
                      "state": null,
                      "country": "US",
                      "country_name": null,
                      "region": "MS",
                      "remote": false,
                      "latitude": null,
                      "longitude": null
                    },
                    "employment_type": null,
                    "experience_level": null,
                    "category": null,
                    "salary": {
                      "min": 20.0,
                      "max": 24.0,
                      "currency": "USD",
                      "period": "hour",
                      "raw": null
                    },
                    "skills": [
                      "quality assurance",
                      "six sigma"
                    ],
                    "valid_through": null,
                    "status": "active",
                    "posted_at": "2026-10-30T00:00:00Z",
                    "updated_at": null,
                    "closed_at": null,
                    "description_html": null,
                    "description_text": null
                  },
                  "meta": {
                    "credits_cost": 1,
                    "credits_remaining": 24996,
                    "request_id": "3a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/count": {
      "get": {
        "operationId": "countJobs",
        "summary": "Count matching active jobs (Free — 0 Credits)",
        "description": "Returns total count of matching active jobs for any filter combination so you can preview volume before paginating. Costs 0 Credits.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "remote",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Job count summary",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": {
                    "total": 14820,
                    "redistribution": "allowed",
                    "include_attributed": false
                  },
                  "meta": {
                    "credits_cost": 0,
                    "credits_remaining": 24996
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/feeds/new": {
      "get": {
        "operationId": "getNewJobsFeed",
        "summary": "Real-time stream of newly discovered job postings",
        "description": "Returns jobs discovered within the requested `since` window (`15m`, `1h`, `6h`, `24h`, `7d`). Costs 1 Credit per job returned.",
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "24h"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Incremental feed of newly posted jobs",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "id": "j_iwnoo5bdjvaf2ivy",
                      "title": "Production Supervisor $20-24 (Canton, MS)",
                      "company": {
                        "name": "Quick Hire Staffing",
                        "slug": "quick-hire-staffing",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "quickhirestaffing",
                          "job_id": "6C5E962163"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/6C5E962163",
                        "apply_url": "https://apply.workable.com/j/6C5E962163",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Canton",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MS",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": null,
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 20.0,
                        "max": 24.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "quality assurance",
                        "six sigma"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-30T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    },
                    {
                      "id": "j_qvhomvqeob3zsmzz",
                      "title": "Assistant Store Manager - Richmond Heights",
                      "company": {
                        "name": "Rebel Convenience Stores",
                        "slug": "rebel-convenience-stores",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "rebel-convenience-stores",
                          "job_id": "5004A54405"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/5004A54405",
                        "apply_url": "https://apply.workable.com/j/5004A54405",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Richmond Heights",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "OH",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": "full_time",
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 17.0,
                        "max": 17.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "customer service"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-29T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    }
                  ],
                  "meta": {
                    "feed_type": "new",
                    "has_more": true,
                    "next_cursor": "2",
                    "credits_cost": 2
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/feeds/updated": {
      "get": {
        "operationId": "getUpdatedJobsFeed",
        "summary": "Real-time stream of updated job postings",
        "description": "Returns jobs whose metadata, salary, or description changed within `since`. Costs 1 Credit per job returned.",
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "24h"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Incremental feed of updated jobs",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "id": "j_iwnoo5bdjvaf2ivy",
                      "title": "Production Supervisor $20-24 (Canton, MS)",
                      "company": {
                        "name": "Quick Hire Staffing",
                        "slug": "quick-hire-staffing",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "quickhirestaffing",
                          "job_id": "6C5E962163"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/6C5E962163",
                        "apply_url": "https://apply.workable.com/j/6C5E962163",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Canton",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MS",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": null,
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 20.0,
                        "max": 24.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "quality assurance",
                        "six sigma"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-30T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    },
                    {
                      "id": "j_qvhomvqeob3zsmzz",
                      "title": "Assistant Store Manager - Richmond Heights",
                      "company": {
                        "name": "Rebel Convenience Stores",
                        "slug": "rebel-convenience-stores",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "rebel-convenience-stores",
                          "job_id": "5004A54405"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/5004A54405",
                        "apply_url": "https://apply.workable.com/j/5004A54405",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Richmond Heights",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "OH",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": "full_time",
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 17.0,
                        "max": 17.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "customer service"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-29T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    }
                  ],
                  "meta": {
                    "feed_type": "updated",
                    "credits_cost": 2
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/feeds/closed": {
      "get": {
        "operationId": "getClosedJobsFeed",
        "summary": "Stream of recently closed / filled / expired job postings",
        "description": "Returns jobs verified closed via 2-step confirmation debounce so downstream job boards can immediately delist dead links. Costs 1 Credit per job returned.",
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "24h"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Incremental feed of closed jobs",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "id": "j_iwnoo5bdjvaf2ivy",
                      "title": "Production Supervisor $20-24 (Canton, MS)",
                      "company": {
                        "name": "Quick Hire Staffing",
                        "slug": "quick-hire-staffing",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "quickhirestaffing",
                          "job_id": "6C5E962163"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/6C5E962163",
                        "apply_url": "https://apply.workable.com/j/6C5E962163",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Canton",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MS",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": null,
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 20.0,
                        "max": 24.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "quality assurance",
                        "six sigma"
                      ],
                      "valid_through": null,
                      "status": "closed",
                      "posted_at": "2026-10-30T00:00:00Z",
                      "updated_at": null,
                      "closed_at": "2026-11-03T01:00:00Z"
                    }
                  ],
                  "meta": {
                    "feed_type": "closed",
                    "credits_cost": 1
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/companies/{slug}/jobs": {
      "get": {
        "operationId": "getCompanyJobs",
        "summary": "Get all open jobs for a company (supports live ETag ATS refresh)",
        "description": "Returns all active jobs for a company slug (e.g., `stripe`, `figma`, `vercel`, `anthropic`, `linear`). Pass `?refresh=true` to trigger a real-time ETag/gzip poll directly against the company's Greenhouse/Lever/Ashby board.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "stripe"
          },
          {
            "name": "refresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Trigger live ETag/gzip check against public Greenhouse/Lever/Ashby board"
          },
          {
            "name": "remote",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Company open positions",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "id": "j_iwnoo5bdjvaf2ivy",
                      "title": "Production Supervisor $20-24 (Canton, MS)",
                      "company": {
                        "name": "Quick Hire Staffing",
                        "slug": "quick-hire-staffing",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "quickhirestaffing",
                          "job_id": "6C5E962163"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/6C5E962163",
                        "apply_url": "https://apply.workable.com/j/6C5E962163",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Canton",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "MS",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": null,
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 20.0,
                        "max": 24.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "quality assurance",
                        "six sigma"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-30T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    },
                    {
                      "id": "j_qvhomvqeob3zsmzz",
                      "title": "Assistant Store Manager - Richmond Heights",
                      "company": {
                        "name": "Rebel Convenience Stores",
                        "slug": "rebel-convenience-stores",
                        "domain": null,
                        "logo_url": null
                      },
                      "source": {
                        "platform": {
                          "name": "workable",
                          "display_name": "Workable",
                          "type": "ats",
                          "board": "rebel-convenience-stores",
                          "job_id": "5004A54405"
                        },
                        "external_id": null,
                        "url": "https://apply.workable.com/j/5004A54405",
                        "apply_url": "https://apply.workable.com/j/5004A54405",
                        "redistribution": "allowed"
                      },
                      "location": {
                        "formatted": null,
                        "city": "Richmond Heights",
                        "state": null,
                        "country": "US",
                        "country_name": null,
                        "region": "OH",
                        "remote": false,
                        "latitude": null,
                        "longitude": null
                      },
                      "employment_type": "full_time",
                      "experience_level": null,
                      "category": null,
                      "salary": {
                        "min": 17.0,
                        "max": 17.0,
                        "currency": "USD",
                        "period": "hour",
                        "raw": null
                      },
                      "skills": [
                        "customer service"
                      ],
                      "valid_through": null,
                      "status": "active",
                      "posted_at": "2026-10-29T00:00:00Z",
                      "updated_at": null,
                      "closed_at": null
                    }
                  ],
                  "meta": {
                    "company_slug": "stripe",
                    "total": 142,
                    "credits_cost": 2
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sources": {
      "get": {
        "operationId": "listSources",
        "summary": "List all 434 ATS platforms & career sources (Free — 0 Credits)",
        "description": "Returns the complete catalog of 434 job sources with active job counts, last scrape timestamp, and redistribution license metadata. Costs 0 Credits.",
        "responses": {
          "200": {
            "description": "434 job sources catalog",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "slug": "abler",
                      "display_name": "Abler",
                      "active_jobs": 11847,
                      "total_jobs": 0,
                      "last_scrape_at": null,
                      "redistribution": "allowed",
                      "license": null,
                      "attribution_required": false,
                      "attribution_text": null
                    },
                    {
                      "slug": "actiris",
                      "display_name": "Actiris",
                      "active_jobs": 0,
                      "total_jobs": 0,
                      "last_scrape_at": null,
                      "redistribution": "attribution_required",
                      "license": {
                        "name": "Actiris terms of use",
                        "terms_url": null,
                        "syndication_allowed": null,
                        "notice": "Credit Actiris and link to the posting. Reuse is subject to the source's own terms of use."
                      },
                      "attribution_required": false,
                      "attribution_text": null
                    },
                    {
                      "slug": "adecco",
                      "display_name": "Adecco",
                      "active_jobs": 4480,
                      "total_jobs": 0,
                      "last_scrape_at": null,
                      "redistribution": "allowed",
                      "license": null,
                      "attribution_required": false,
                      "attribution_text": null
                    },
                    {
                      "slug": "adp",
                      "display_name": "Adp",
                      "active_jobs": 160382,
                      "total_jobs": 0,
                      "last_scrape_at": null,
                      "redistribution": "allowed",
                      "license": null,
                      "attribution_required": false,
                      "attribution_text": null
                    },
                    {
                      "slug": "adprecruiting",
                      "display_name": "Adprecruiting",
                      "active_jobs": 70877,
                      "total_jobs": 0,
                      "last_scrape_at": null,
                      "redistribution": "allowed",
                      "license": null,
                      "attribution_required": false,
                      "attribution_text": null
                    }
                  ],
                  "meta": {
                    "total": 434,
                    "credits_cost": 0
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/taxonomy/skills": {
      "get": {
        "operationId": "listSkillsTaxonomy",
        "summary": "Normalized skills taxonomy with active job counts (Free — 0 Credits)",
        "responses": {
          "200": {
            "description": "Top skills and job counts",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "skill": "python",
                      "active_jobs": 42150
                    },
                    {
                      "skill": "typescript",
                      "active_jobs": 28400
                    },
                    {
                      "skill": "kubernetes",
                      "active_jobs": 19320
                    }
                  ],
                  "meta": {
                    "credits_cost": 0
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/taxonomy/locations": {
      "get": {
        "operationId": "listLocationsTaxonomy",
        "summary": "Normalized countries & regions taxonomy with active job counts (Free — 0 Credits)",
        "responses": {
          "200": {
            "description": "Countries and active job counts",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "country": "US",
                      "country_name": "United States",
                      "region": "North America",
                      "active_jobs": 4820000,
                      "remote_jobs": 612000
                    }
                  ],
                  "meta": {
                    "credits_cost": 0
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/tools/ats-detector": {
      "get": {
        "operationId": "detectCompanyAts",
        "summary": "Detect a company's ATS platform, board token & open job count (Free — 0 Credits)",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "stripe.com"
          }
        ],
        "responses": {
          "200": {
            "description": "ATS detection result",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": {
                    "domain": "stripe.com",
                    "company_slug": "stripe",
                    "company_name": "Stripe",
                    "detected": true,
                    "ats_platform": "greenhouse",
                    "board_token": "stripe",
                    "board_api_url": "https://boards-api.greenhouse.io/v1/boards/stripe/jobs",
                    "career_url": "https://stripe.com/jobs",
                    "active_jobs_count": 312,
                    "sample_jobs": [
                      {
                        "id": "j_iwnoo5bdjvaf2ivy",
                        "title": "Production Supervisor $20-24 (Canton, MS)",
                        "company": {
                          "name": "Quick Hire Staffing",
                          "slug": "quick-hire-staffing",
                          "domain": null,
                          "logo_url": null
                        },
                        "source": {
                          "platform": {
                            "name": "workable",
                            "display_name": "Workable",
                            "type": "ats",
                            "board": "quickhirestaffing",
                            "job_id": "6C5E962163"
                          },
                          "external_id": null,
                          "url": "https://apply.workable.com/j/6C5E962163",
                          "apply_url": "https://apply.workable.com/j/6C5E962163",
                          "redistribution": "allowed"
                        },
                        "location": {
                          "formatted": null,
                          "city": "Canton",
                          "state": null,
                          "country": "US",
                          "country_name": null,
                          "region": "MS",
                          "remote": false,
                          "latitude": null,
                          "longitude": null
                        },
                        "employment_type": null,
                        "experience_level": null,
                        "category": null,
                        "salary": {
                          "min": 20.0,
                          "max": 24.0,
                          "currency": "USD",
                          "period": "hour",
                          "raw": null
                        },
                        "skills": [
                          "quality assurance",
                          "six sigma"
                        ],
                        "valid_through": null,
                        "status": "active",
                        "posted_at": "2026-10-30T00:00:00Z",
                        "updated_at": null,
                        "closed_at": null
                      },
                      {
                        "id": "j_qvhomvqeob3zsmzz",
                        "title": "Assistant Store Manager - Richmond Heights",
                        "company": {
                          "name": "Rebel Convenience Stores",
                          "slug": "rebel-convenience-stores",
                          "domain": null,
                          "logo_url": null
                        },
                        "source": {
                          "platform": {
                            "name": "workable",
                            "display_name": "Workable",
                            "type": "ats",
                            "board": "rebel-convenience-stores",
                            "job_id": "5004A54405"
                          },
                          "external_id": null,
                          "url": "https://apply.workable.com/j/5004A54405",
                          "apply_url": "https://apply.workable.com/j/5004A54405",
                          "redistribution": "allowed"
                        },
                        "location": {
                          "formatted": null,
                          "city": "Richmond Heights",
                          "state": null,
                          "country": "US",
                          "country_name": null,
                          "region": "OH",
                          "remote": false,
                          "latitude": null,
                          "longitude": null
                        },
                        "employment_type": "full_time",
                        "experience_level": null,
                        "category": null,
                        "salary": {
                          "min": 17.0,
                          "max": 17.0,
                          "currency": "USD",
                          "period": "hour",
                          "raw": null
                        },
                        "skills": [
                          "customer service"
                        ],
                        "valid_through": null,
                        "status": "active",
                        "posted_at": "2026-10-29T00:00:00Z",
                        "updated_at": null,
                        "closed_at": null
                      }
                    ]
                  },
                  "meta": {
                    "credits_cost": 0
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "operationId": "getHealth",
        "summary": "Gateway health & live index coverage stats (Free — 0 Credits)",
        "security": [],
        "responses": {
          "200": {
            "description": "Health & index statistics",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": {
                    "service": "jobpostingsapi.com",
                    "status": "healthy",
                    "active_jobs": 18248034,
                    "redistributable_jobs": 9942100,
                    "attributed_jobs": 8305934,
                    "active_sources": 434
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
