{
  "data": {
    "id": "CBIJjkUaFVPD5Gjej",
    "actId": "O6NhNrNCvlYhdI90w",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-17T16:50:19.747Z",
    "finishedAt": "2026-11-17T16:50:31.138Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 11245,
      "runTimeSecs": 11.245,
      "computeUnits": 0.012494444444444445,
      "imageSizeBytes": 332521984
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"USAJOBS Federal Vacancy & Pay Grade Finder Input\",\n  \"description\": \"Search live USAJOBS federal postings by keyword, location, agency, pay grade, schedule, clearance and hiring path, or read the full details of specific job links. No API key or login is required.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"Search federal vacancies, or read full details for job links you already have.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"searchJobs\",\n        \"jobDetails\"\n      ],\n      \"enumTitles\": [\n        \"Search federal job postings\",\n        \"Get details for specific job links\"\n      ],\n      \"default\": \"searchJobs\",\n      \"prefill\": \"searchJobs\"\n    },\n    \"keyword\": {\n      \"title\": \"Keyword\",\n      \"type\": \"string\",\n      \"description\": \"Job title, skill or keyword to search for (for example \\\"software engineer\\\" or \\\"data analyst\\\").\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"software engineer\"\n    },\n    \"locationName\": {\n      \"title\": \"Location\",\n      \"type\": \"string\",\n      \"description\": \"City, state or country to search in, for example \\\"Washington, DC\\\" or \\\"Germany\\\".\",\n      \"editor\": \"textfield\"\n    },\n    \"department\": {\n      \"title\": \"Department\",\n      \"type\": \"string\",\n      \"description\": \"Parent federal department name, acronym or code, for example \\\"Department of Defense\\\", \\\"DOD\\\" or \\\"DD\\\". Comma-separate several values.\",\n      \"editor\": \"textfield\"\n    },\n    \"agency\": {\n      \"title\": \"Agency / Organization\",\n      \"type\": \"string\",\n      \"description\": \"Agency or department name, acronym or code, for example \\\"NASA\\\", \\\"Department of the Navy\\\" or \\\"NV27\\\". Comma-separate several values.\",\n      \"editor\": \"textfield\"\n    },\n    \"jobCategoryCode\": {\n      \"title\": \"Occupational Series Codes\",\n      \"type\": \"string\",\n      \"description\": \"Four-digit federal occupational series codes, comma-separated (for example \\\"2210\\\" for IT or \\\"0343\\\" for management analysis).\",\n      \"editor\": \"textfield\"\n    },\n    \"gradeMin\": {\n      \"title\": \"Minimum Pay Grade\",\n      \"type\": \"integer\",\n      \"description\": \"Lowest GS-equivalent grade to include (1-15).\",\n      \"minimum\": 1,\n      \"maximum\": 15\n    },\n    \"gradeMax\": {\n      \"title\": \"Maximum Pay Grade\",\n      \"type\": \"integer\",\n      \"description\": \"Highest GS-equivalent grade to include (1-15).\",\n      \"minimum\": 1,\n      \"maximum\": 15\n    },\n    \"schedule\": {\n      \"title\": \"Work Schedule\",\n      \"type\": \"string\",\n      \"description\": \"Filter by the posting's work schedule.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"1\",\n        \"2\",\n        \"3\",\n        \"4\",\n        \"5\",\n        \"6\"\n      ],\n      \"enumTitles\": [\n        \"Any schedule\",\n        \"Full-time\",\n        \"Part-time\",\n        \"Shift work\",\n        \"Intermittent\",\n        \"Job sharing\",\n        \"Multiple schedules\"\n      ],\n      \"default\": \"\"\n    },\n    \"hiringPath\": {\n      \"title\": \"Who May Apply\",\n      \"type\": \"string\",\n      \"description\": \"Filter by the audience the posting is open to.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"public\",\n        \"fed-competitive\",\n        \"fed-excepted\",\n        \"fed-internal-search\",\n        \"fed-transition\",\n        \"land\",\n        \"vet\",\n        \"mspouse\",\n        \"nguard\",\n        \"student\",\n        \"graduates\",\n        \"ses\",\n        \"disability\",\n        \"overseas\",\n        \"native\",\n        \"peace\",\n        \"special-authorities\"\n      ],\n      \"enumTitles\": [\n        \"Any hiring path\",\n        \"Open to the public\",\n        \"Competitive service\",\n        \"Excepted service\",\n        \"Internal to an agency\",\n        \"Career transition (CTAP, ICTAP, RPL)\",\n        \"Land and base management\",\n        \"Veterans\",\n        \"Military spouses\",\n        \"National Guard and reserves\",\n        \"Students\",\n        \"Recent graduates\",\n        \"Senior Executive Service\",\n        \"Individuals with disabilities\",\n        \"Family of overseas employees\",\n        \"Native Americans\",\n        \"Peace Corps & AmeriCorps Vista\",\n        \"Special authorities\"\n      ],\n      \"default\": \"\"\n    },\n    \"securityClearance\": {\n      \"title\": \"Security Clearance\",\n      \"type\": \"string\",\n      \"description\": \"Filter by the clearance level a posting requires.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"0\",\n        \"1\",\n        \"2\",\n        \"3\",\n        \"4\",\n        \"5\",\n        \"7\",\n        \"8\"\n      ],\n      \"enumTitles\": [\n        \"Any clearance\",\n        \"Not Required\",\n        \"Confidential\",\n        \"Secret\",\n        \"Top secret\",\n        \"Sensitive Compartmented Information\",\n        \"Q Access Authorization\",\n        \"L Access Authorization\",\n        \"Other\"\n      ],\n      \"default\": \"\"\n    },\n    \"jobType\": {\n      \"title\": \"Appointment Type\",\n      \"type\": \"string\",\n      \"description\": \"Filter by appointment or job type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"15317\",\n        \"15318\",\n        \"15319\",\n        \"15320\",\n        \"15321\",\n        \"15322\",\n        \"15323\",\n        \"15326\",\n        \"15327\",\n        \"15328\",\n        \"15522\"\n      ],\n      \"enumTitles\": [\n        \"Any appointment type\",\n        \"Permanent\",\n        \"Temporary\",\n        \"Term\",\n        \"Detail\",\n        \"Temporary promotion\",\n        \"Seasonal\",\n        \"Summer\",\n        \"Recent graduates\",\n        \"Multiple\",\n        \"Internships\",\n        \"Intermittent\"\n      ],\n      \"default\": \"\"\n    },\n    \"travelPercentage\": {\n      \"title\": \"Travel Required\",\n      \"type\": \"string\",\n      \"description\": \"Filter by how much travel the posting requires.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"0\",\n        \"1\",\n        \"2\",\n        \"5\",\n        \"7\",\n        \"8\"\n      ],\n      \"enumTitles\": [\n        \"Any travel\",\n        \"Not required\",\n        \"Occasional travel\",\n        \"25% or less\",\n        \"50% or less\",\n        \"75% or less\",\n        \"76% or greater\"\n      ],\n      \"default\": \"\"\n    },\n    \"workSite\": {\n      \"title\": \"Work Site\",\n      \"type\": \"string\",\n      \"description\": \"Filter for remote jobs, exclude remote jobs, or find telework-eligible jobs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"remote\",\n        \"excludeRemote\",\n        \"telework\"\n      ],\n      \"enumTitles\": [\n        \"Any work site\",\n        \"Remote jobs only\",\n        \"Exclude remote jobs\",\n        \"Offers telework\"\n      ],\n      \"default\": \"\"\n    },\n    \"relocationAssistance\": {\n      \"title\": \"Relocation Assistance Only\",\n      \"type\": \"boolean\",\n      \"description\": \"Only return postings that reimburse relocation expenses.\",\n      \"default\": false\n    },\n    \"minSalary\": {\n      \"title\": \"Minimum Salary (USD)\",\n      \"type\": \"integer\",\n      \"description\": \"Only return postings whose advertised starting salary is at least this amount.\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"sortBy\": {\n      \"title\": \"Sort Results\",\n      \"type\": \"string\",\n      \"description\": \"Order of returned postings.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"recentlyPosted\",\n        \"closingSoon\",\n        \"highestSalary\",\n        \"lowestSalary\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (default)\",\n        \"Recently posted\",\n        \"Closing soon\",\n        \"Highest salary\",\n        \"Lowest salary\"\n      ],\n      \"default\": \"\"\n    },\n    \"includeDetails\": {\n      \"title\": \"Include Full Job Details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each posting's full announcement for duties, qualifications, education, salary range, remote/telework status and clearance. Turn off for a faster, lighter run.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"jobUrls\": {\n      \"title\": \"Job Links or IDs (Job Details mode)\",\n      \"type\": \"array\",\n      \"description\": \"In Job Details mode, paste USAJOBS job links (https://www.usajobs.gov/job/123456789) or bare control numbers.\",\n      \"editor\": \"stringList\"\n    },\n    \"maxItems\": {\n      \"title\": \"Max Items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of postings to return.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 50,\n      \"prefill\": 2\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# USAJOBS Federal Vacancy & Pay Grade Finder\n\nUSAJOBS is the US government's official federal job board. This actor reads its live public search and announcement pages directly, so it returns federal vacancies, pay scales and grades, salary ranges, hiring paths, clearance requirements and full announcement text **with no API key, login or cookie**.\n\n## What this actor does\n\n- Searches current federal postings by keyword, location, agency or parent department, occupational series, GS-equivalent grade range, work schedule, hiring path, clearance, appointment type, travel, work site (remote / telework / exclude remote), relocation assistance and minimum salary.\n- Pages through the full result set (up to USAJOBS's own 10,000-result ceiling), removes duplicate postings and stops at `maxItems`.\n- Optionally opens each posting's announcement page to add duties, qualifications, education, evaluation criteria, exact salary range, promotion potential and remote/telework status.\n- Reads individual announcement links in **Job Details** mode, so you can enrich a list of job URLs you already collected.\n- Keeps the older input keys (`organization`, `positionSchedule`, `whoMayApply`, `gradeMin`, `gradeMax`, `apiKey`, `datePostedDays`) working in code, so saved tasks keep running.\n\n## Modes\n\n| Mode | What it returns | Main inputs |\n| --- | --- | --- |\n| **Search federal job postings** (`searchJobs`) | A record per matching vacancy from the live USAJOBS search. | `keyword`, `locationName`, `agency`, `department`, `jobCategoryCode`, grade range, schedule, hiring path, clearance, job type, travel, work site, salary, sort. |\n| **Get details for specific job links** (`jobDetails`) | A full record for each announcement URL or control number you supply. | `jobUrls` (or `documentId` in the link), `maxItems`. |\n\n### Example: software engineer roles, GS 9-12, open to the public\n\n```json\n{\n  \"mode\": \"searchJobs\",\n  \"keyword\": \"software engineer\",\n  \"gradeMin\": 9,\n  \"gradeMax\": 12,\n  \"hiringPath\": \"public\",\n  \"includeDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: remote data roles at a named agency\n\n```json\n{\n  \"mode\": \"searchJobs\",\n  \"keyword\": \"data analyst\",\n  \"agency\": \"NASA\",\n  \"workSite\": \"remote\",\n  \"sortBy\": \"recentlyPosted\",\n  \"maxItems\": 100\n}\n```\n\n### Example: enrich two job links\n\n```json\n{\n  \"mode\": \"jobDetails\",\n  \"jobUrls\": [\n    \"https://www.usajobs.gov/job/893002300\",\n    \"https://www.usajobs.gov/job/892113500\"\n  ]\n}\n```\n\n## Input\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `mode` | Select | `searchJobs` | Search postings or read specific job links. |\n| `keyword` | String | – (prefill: `software engineer`) | Job title, skill or keyword. Leave empty to browse all postings. |\n| `locationName` | String | – | City, state or country, e.g. `Washington, DC` or `Germany`. |\n| `department` | String | – | Parent department name, acronym or code, e.g. `Department of Defense`, `DOD` or `DD`. Comma-separate multiple values. |\n| `agency` | String | – | Agency or department name, acronym or code, e.g. `NASA`, `Department of the Navy` or `NV27`. Comma-separate multiple values. |\n| `jobCategoryCode` | String | – | Four-digit occupational series codes, comma-separated (e.g. `2210` for IT, `0343` for management analysis). |\n| `gradeMin` / `gradeMax` | Integer | – | GS-equivalent grade range, 1-15. |\n| `schedule` | Select | Any | Full-time, part-time, shift work, intermittent, job sharing or multiple schedules. |\n| `hiringPath` | Select | Any | Public, competitive service, excepted service, internal, transition, veterans, military spouses, students, graduates, disability, overseas, special authorities and more. |\n| `securityClearance` | Select | Any | Not required, confidential, secret, top secret, SCI, Q/L access or other. |\n| `jobType` | Select | Any | Permanent, temporary, term, detail, seasonal, summer, internships, recent graduates and more. |\n| `travelPercentage` | Select | Any | None, occasional, or 25/50/75/76%+ travel. |\n| `workSite` | Select | Any | Remote jobs only, exclude remote jobs, or telework-eligible jobs. |\n| `relocationAssistance` | Boolean | `false` | Only postings that reimburse relocation. |\n| `minSalary` | Integer | – | Minimum advertised annual salary in USD. |\n| `sortBy` | Select | – (relevance) | Recently posted, closing soon, highest salary or lowest salary. |\n| `includeDetails` | Boolean | `true` | Open each announcement for duties, qualifications, education and exact salary range. Turn off for faster, lighter runs. |\n| `jobUrls` | String list | – | In Job Details mode: `https://www.usajobs.gov/job/<id>` links or bare control numbers. |\n| `maxItems` | Integer | `50` | Maximum records to return (1-5,000). |\n\n## Output per posting\n\n| Field | Description |\n| --- | --- |\n| `positionId` | The agency announcement number (e.g. `27-DO-13105675-DH`). |\n| `documentId` | USAJOBS control number; also the ID in the job URL. |\n| `positionTitle` | Job title. |\n| `positionUri` / `sourceUrl` | Clean canonical link to the announcement. |\n| `organizationName` / `subAgency` / `departmentName` | Hiring agency, sub-agency and parent department. |\n| `hiringOrganization` | Hiring organization exactly as published in the announcement metadata. |\n| `locationName` / `locationDisplay` | Primary duty station and the display form with extra locations. |\n| `positionLocalities` / `positionLocationCount` | Every duty station listed and how many there are. |\n| `positionStartDate` / `datePosted` / `applicationCloseDate` | Open date, posted date and application deadline (ISO dates). |\n| `salaryMin` / `salaryMax` | Advertised salary range in the stated unit. |\n| `salaryCurrency` / `salaryUnit` | `USD` and `year` or `hour`. |\n| `payScale` / `payGradeMin` / `payGradeMax` | Pay plan and grade range, e.g. `GS` 13-14 or `NF` 4. |\n| `promotionPotential` | Highest grade the posting can promote to. |\n| `positionSchedule` / `appointmentType` / `travelRequirement` | Work schedule, appointment type and travel requirement. |\n| `whoMayApply` / `hiringPaths` / `hiringPathCodes` | First eligible audience plus every hiring path, as labels and codes. |\n| `relocationReimbursed` | Whether relocation expenses are reimbursed. |\n| `securityClearance` / `securityClearanceRequired` | Clearance text and a simple required/not-required flag. |\n| `remoteIndicator` / `teleworkEligible` | Remote-job flag and telework eligibility. |\n| `jobSummary` / `duties` / `requirementsSummary` | Announcement summary, duties and conditions of employment. |\n| `qualificationSummary` / `education` / `evaluationCriteria` | Qualifications, education requirement and how applicants are evaluated. |\n| `jobCategories` / `jobCategoryCodes` | Occupational series names and four-digit codes. |\n| `dateDisplay` / `closingSoon` | Human-readable date line and the site's closing-soon badge. |\n| `recordType` / `scrapedAt` | `job` and the ISO timestamp of capture. |\n\nFields the source does not publish for a posting are omitted; nothing is emitted as `null`, blank or a placeholder.\n\n## How it works\n\nThe actor calls the same public search endpoint the USAJOBS website uses, then reads announcement pages for full details. No API key is needed. Requests are retried on rate limits and transient server errors, and if a datacenter address is blocked the actor automatically retries through Apify's included datacenter proxy.\n\n## Limitations\n\n- **USAJOBS caps a single search at 10,000 postings.** Narrow by agency, location, grade, series or keyword to reach postings beyond that ceiling.\n- **Date-posted filtering is not available on the public search.** The legacy `datePostedDays` key is accepted but ignored; use `sortBy: recentlyPosted` and `maxItems` instead.\n- **Full announcement text is as published.** Very long duties or qualification sections are returned whole, which makes detail-enabled runs heavier than search-only runs.\n- **Grade filtering follows USAJOBS's GS-equivalent buckets.** Some pay plans (for example SV or NF) use letter grades and may not match a numeric GS range.\n- **A removed or closed announcement can still appear briefly in search.** If its detail page is already gone, the core search fields are still returned and the run reports how many detail pages could not be opened.\n\n## FAQ\n\n**Do I need a USAJOBS API key?**\nNo. This actor uses the public website search and announcement pages, so it needs no API key, account, cookie or proxy setup. The old `apiKey` key is accepted but ignored.\n\n**Can I search by GS pay grade?**\nYes. Set `gradeMin` and/or `gradeMax` (1-15). Results include every GS-equivalent grade in the range, and each record reports `payScale`, `payGradeMin` and `payGradeMax`.\n\n**What does \"Who May Apply\" mean?**\nIt is the audience the posting is open to: public means any US citizen, competitive service means current or former federal employees, and other hiring paths cover veterans, military spouses, students, graduates, disability, overseas family members and special authorities.\n\n**Why is a field such as `salaryMax` missing?**\nSome announcements publish only a starting salary. The actor omits the missing bound rather than guessing.\n\n**Is this affiliated with USAJOBS or the US government?**\nNo. This is an independent tool and is not affiliated with, endorsed by or sponsored by USAJOBS or the US Office of Personnel Management.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "usajobs-federal-vacancy-and-pay-grade-finder",
      "title": "USAJOBS Federal Vacancy & Pay Grade Finder",
      "description": "Search live USAJOBS federal postings by keyword, location, agency, GS pay grade, schedule, clearance and hiring path. Returns salary range, duties, qualifications, remote/telework status and application deadlines without an API key.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# USAJOBS Federal Vacancy & Pay Grade Finder\n\nUSAJOBS is the US government's official federal job board. This actor reads its live public search and announcement pages directly, so it returns federal vacancies, pay scales and grades, salary ranges, hiring paths, clearance requirements and full announcement text **with no API key, login or cookie**.\n\n## What this actor does\n\n- Searches current federal postings by keyword, location, agency or parent department, occupational series, GS-equivalent grade range, work schedule, hiring path, clearance, appointment type, travel, work site (remote / telework / exclude remote), relocation assistance and minimum salary.\n- Pages through the full result set (up to USAJOBS's own 10,000-result ceiling), removes duplicate postings and stops at `maxItems`.\n- Optionally opens each posting's announcement page to add duties, qualifications, education, evaluation criteria, exact salary range, promotion potential and remote/telework status.\n- Reads individual announcement links in **Job Details** mode, so you can enrich a list of job URLs you already collected.\n- Keeps the older input keys (`organization`, `positionSchedule`, `whoMayApply`, `gradeMin`, `gradeMax`, `apiKey`, `datePostedDays`) working in code, so saved tasks keep running.\n\n## Modes\n\n| Mode | What it returns | Main inputs |\n| --- | --- | --- |\n| **Search federal job postings** (`searchJobs`) | A record per matching vacancy from the live USAJOBS search. | `keyword`, `locationName`, `agency`, `department`, `jobCategoryCode`, grade range, schedule, hiring path, clearance, job type, travel, work site, salary, sort. |\n| **Get details for specific job links** (`jobDetails`) | A full record for each announcement URL or control number you supply. | `jobUrls` (or `documentId` in the link), `maxItems`. |\n\n### Example: software engineer roles, GS 9-12, open to the public\n\n```json\n{\n  \"mode\": \"searchJobs\",\n  \"keyword\": \"software engineer\",\n  \"gradeMin\": 9,\n  \"gradeMax\": 12,\n  \"hiringPath\": \"public\",\n  \"includeDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: remote data roles at a named agency\n\n```json\n{\n  \"mode\": \"searchJobs\",\n  \"keyword\": \"data analyst\",\n  \"agency\": \"NASA\",\n  \"workSite\": \"remote\",\n  \"sortBy\": \"recentlyPosted\",\n  \"maxItems\": 100\n}\n```\n\n### Example: enrich two job links\n\n```json\n{\n  \"mode\": \"jobDetails\",\n  \"jobUrls\": [\n    \"https://www.usajobs.gov/job/893002300\",\n    \"https://www.usajobs.gov/job/892113500\"\n  ]\n}\n```\n\n## Input\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `mode` | Select | `searchJobs` | Search postings or read specific job links. |\n| `keyword` | String | – (prefill: `software engineer`) | Job title, skill or keyword. Leave empty to browse all postings. |\n| `locationName` | String | – | City, state or country, e.g. `Washington, DC` or `Germany`. |\n| `department` | String | – | Parent department name, acronym or code, e.g. `Department of Defense`, `DOD` or `DD`. Comma-separate multiple values. |\n| `agency` | String | – | Agency or department name, acronym or code, e.g. `NASA`, `Department of the Navy` or `NV27`. Comma-separate multiple values. |\n| `jobCategoryCode` | String | – | Four-digit occupational series codes, comma-separated (e.g. `2210` for IT, `0343` for management analysis). |\n| `gradeMin` / `gradeMax` | Integer | – | GS-equivalent grade range, 1-15. |\n| `schedule` | Select | Any | Full-time, part-time, shift work, intermittent, job sharing or multiple schedules. |\n| `hiringPath` | Select | Any | Public, competitive service, excepted service, internal, transition, veterans, military spouses, students, graduates, disability, overseas, special authorities and more. |\n| `securityClearance` | Select | Any | Not required, confidential, secret, top secret, SCI, Q/L access or other. |\n| `jobType` | Select | Any | Permanent, temporary, term, detail, seasonal, summer, internships, recent graduates and more. |\n| `travelPercentage` | Select | Any | None, occasional, or 25/50/75/76%+ travel. |\n| `workSite` | Select | Any | Remote jobs only, exclude remote jobs, or telework-eligible jobs. |\n| `relocationAssistance` | Boolean | `false` | Only postings that reimburse relocation. |\n| `minSalary` | Integer | – | Minimum advertised annual salary in USD. |\n| `sortBy` | Select | – (relevance) | Recently posted, closing soon, highest salary or lowest salary. |\n| `includeDetails` | Boolean | `true` | Open each announcement for duties, qualifications, education and exact salary range. Turn off for faster, lighter runs. |\n| `jobUrls` | String list | – | In Job Details mode: `https://www.usajobs.gov/job/<id>` links or bare control numbers. |\n| `maxItems` | Integer | `50` | Maximum records to return (1-5,000). |\n\n## Output per posting\n\n| Field | Description |\n| --- | --- |\n| `positionId` | The agency announcement number (e.g. `27-DO-13105675-DH`). |\n| `documentId` | USAJOBS control number; also the ID in the job URL. |\n| `positionTitle` | Job title. |\n| `positionUri` / `sourceUrl` | Clean canonical link to the announcement. |\n| `organizationName` / `subAgency` / `departmentName` | Hiring agency, sub-agency and parent department. |\n| `hiringOrganization` | Hiring organization exactly as published in the announcement metadata. |\n| `locationName` / `locationDisplay` | Primary duty station and the display form with extra locations. |\n| `positionLocalities` / `positionLocationCount` | Every duty station listed and how many there are. |\n| `positionStartDate` / `datePosted` / `applicationCloseDate` | Open date, posted date and application deadline (ISO dates). |\n| `salaryMin` / `salaryMax` | Advertised salary range in the stated unit. |\n| `salaryCurrency` / `salaryUnit` | `USD` and `year` or `hour`. |\n| `payScale` / `payGradeMin` / `payGradeMax` | Pay plan and grade range, e.g. `GS` 13-14 or `NF` 4. |\n| `promotionPotential` | Highest grade the posting can promote to. |\n| `positionSchedule` / `appointmentType` / `travelRequirement` | Work schedule, appointment type and travel requirement. |\n| `whoMayApply` / `hiringPaths` / `hiringPathCodes` | First eligible audience plus every hiring path, as labels and codes. |\n| `relocationReimbursed` | Whether relocation expenses are reimbursed. |\n| `securityClearance` / `securityClearanceRequired` | Clearance text and a simple required/not-required flag. |\n| `remoteIndicator` / `teleworkEligible` | Remote-job flag and telework eligibility. |\n| `jobSummary` / `duties` / `requirementsSummary` | Announcement summary, duties and conditions of employment. |\n| `qualificationSummary` / `education` / `evaluationCriteria` | Qualifications, education requirement and how applicants are evaluated. |\n| `jobCategories` / `jobCategoryCodes` | Occupational series names and four-digit codes. |\n| `dateDisplay` / `closingSoon` | Human-readable date line and the site's closing-soon badge. |\n| `recordType` / `scrapedAt` | `job` and the ISO timestamp of capture. |\n\nFields the source does not publish for a posting are omitted; nothing is emitted as `null`, blank or a placeholder.\n\n## How it works\n\nThe actor calls the same public search endpoint the USAJOBS website uses, then reads announcement pages for full details. No API key is needed. Requests are retried on rate limits and transient server errors, and if a datacenter address is blocked the actor automatically retries through Apify's included datacenter proxy.\n\n## Limitations\n\n- **USAJOBS caps a single search at 10,000 postings.** Narrow by agency, location, grade, series or keyword to reach postings beyond that ceiling.\n- **Date-posted filtering is not available on the public search.** The legacy `datePostedDays` key is accepted but ignored; use `sortBy: recentlyPosted` and `maxItems` instead.\n- **Full announcement text is as published.** Very long duties or qualification sections are returned whole, which makes detail-enabled runs heavier than search-only runs.\n- **Grade filtering follows USAJOBS's GS-equivalent buckets.** Some pay plans (for example SV or NF) use letter grades and may not match a numeric GS range.\n- **A removed or closed announcement can still appear briefly in search.** If its detail page is already gone, the core search fields are still returned and the run reports how many detail pages could not be opened.\n\n## FAQ\n\n**Do I need a USAJOBS API key?**\nNo. This actor uses the public website search and announcement pages, so it needs no API key, account, cookie or proxy setup. The old `apiKey` key is accepted but ignored.\n\n**Can I search by GS pay grade?**\nYes. Set `gradeMin` and/or `gradeMax` (1-15). Results include every GS-equivalent grade in the range, and each record reports `payScale`, `payGradeMin` and `payGradeMax`.\n\n**What does \"Who May Apply\" mean?**\nIt is the audience the posting is open to: public means any US citizen, competitive service means current or former federal employees, and other hiring paths cover veterans, military spouses, students, graduates, disability, overseas family members and special authorities.\n\n**Why is a field such as `salaryMax` missing?**\nSome announcements publish only a starting salary. The actor omits the missing bound rather than guessing.\n\n**Is this affiliated with USAJOBS or the US government?**\nNo. This is an independent tool and is not affiliated with, endorsed by or sponsored by USAJOBS or the US Office of Personnel Management.\n",
      "input": {
        "title": "USAJOBS Federal Vacancy & Pay Grade Finder Input",
        "description": "Search live USAJOBS federal postings by keyword, location, agency, pay grade, schedule, clearance and hiring path, or read the full details of specific job links. No API key or login is required.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "Search federal vacancies, or read full details for job links you already have.",
            "editor": "select",
            "enum": [
              "searchJobs",
              "jobDetails"
            ],
            "enumTitles": [
              "Search federal job postings",
              "Get details for specific job links"
            ],
            "default": "searchJobs",
            "prefill": "searchJobs"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Job title, skill or keyword to search for (for example \"software engineer\" or \"data analyst\").",
            "editor": "textfield",
            "prefill": "software engineer"
          },
          "locationName": {
            "title": "Location",
            "type": "string",
            "description": "City, state or country to search in, for example \"Washington, DC\" or \"Germany\".",
            "editor": "textfield"
          },
          "department": {
            "title": "Department",
            "type": "string",
            "description": "Parent federal department name, acronym or code, for example \"Department of Defense\", \"DOD\" or \"DD\". Comma-separate several values.",
            "editor": "textfield"
          },
          "agency": {
            "title": "Agency / Organization",
            "type": "string",
            "description": "Agency or department name, acronym or code, for example \"NASA\", \"Department of the Navy\" or \"NV27\". Comma-separate several values.",
            "editor": "textfield"
          },
          "jobCategoryCode": {
            "title": "Occupational Series Codes",
            "type": "string",
            "description": "Four-digit federal occupational series codes, comma-separated (for example \"2210\" for IT or \"0343\" for management analysis).",
            "editor": "textfield"
          },
          "gradeMin": {
            "title": "Minimum Pay Grade",
            "type": "integer",
            "description": "Lowest GS-equivalent grade to include (1-15).",
            "minimum": 1,
            "maximum": 15
          },
          "gradeMax": {
            "title": "Maximum Pay Grade",
            "type": "integer",
            "description": "Highest GS-equivalent grade to include (1-15).",
            "minimum": 1,
            "maximum": 15
          },
          "schedule": {
            "title": "Work Schedule",
            "type": "string",
            "description": "Filter by the posting's work schedule.",
            "editor": "select",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5",
              "6"
            ],
            "enumTitles": [
              "Any schedule",
              "Full-time",
              "Part-time",
              "Shift work",
              "Intermittent",
              "Job sharing",
              "Multiple schedules"
            ],
            "default": ""
          },
          "hiringPath": {
            "title": "Who May Apply",
            "type": "string",
            "description": "Filter by the audience the posting is open to.",
            "editor": "select",
            "enum": [
              "",
              "public",
              "fed-competitive",
              "fed-excepted",
              "fed-internal-search",
              "fed-transition",
              "land",
              "vet",
              "mspouse",
              "nguard",
              "student",
              "graduates",
              "ses",
              "disability",
              "overseas",
              "native",
              "peace",
              "special-authorities"
            ],
            "enumTitles": [
              "Any hiring path",
              "Open to the public",
              "Competitive service",
              "Excepted service",
              "Internal to an agency",
              "Career transition (CTAP, ICTAP, RPL)",
              "Land and base management",
              "Veterans",
              "Military spouses",
              "National Guard and reserves",
              "Students",
              "Recent graduates",
              "Senior Executive Service",
              "Individuals with disabilities",
              "Family of overseas employees",
              "Native Americans",
              "Peace Corps & AmeriCorps Vista",
              "Special authorities"
            ],
            "default": ""
          },
          "securityClearance": {
            "title": "Security Clearance",
            "type": "string",
            "description": "Filter by the clearance level a posting requires.",
            "editor": "select",
            "enum": [
              "",
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              "7",
              "8"
            ],
            "enumTitles": [
              "Any clearance",
              "Not Required",
              "Confidential",
              "Secret",
              "Top secret",
              "Sensitive Compartmented Information",
              "Q Access Authorization",
              "L Access Authorization",
              "Other"
            ],
            "default": ""
          },
          "jobType": {
            "title": "Appointment Type",
            "type": "string",
            "description": "Filter by appointment or job type.",
            "editor": "select",
            "enum": [
              "",
              "15317",
              "15318",
              "15319",
              "15320",
              "15321",
              "15322",
              "15323",
              "15326",
              "15327",
              "15328",
              "15522"
            ],
            "enumTitles": [
              "Any appointment type",
              "Permanent",
              "Temporary",
              "Term",
              "Detail",
              "Temporary promotion",
              "Seasonal",
              "Summer",
              "Recent graduates",
              "Multiple",
              "Internships",
              "Intermittent"
            ],
            "default": ""
          },
          "travelPercentage": {
            "title": "Travel Required",
            "type": "string",
            "description": "Filter by how much travel the posting requires.",
            "editor": "select",
            "enum": [
              "",
              "0",
              "1",
              "2",
              "5",
              "7",
              "8"
            ],
            "enumTitles": [
              "Any travel",
              "Not required",
              "Occasional travel",
              "25% or less",
              "50% or less",
              "75% or less",
              "76% or greater"
            ],
            "default": ""
          },
          "workSite": {
            "title": "Work Site",
            "type": "string",
            "description": "Filter for remote jobs, exclude remote jobs, or find telework-eligible jobs.",
            "editor": "select",
            "enum": [
              "",
              "remote",
              "excludeRemote",
              "telework"
            ],
            "enumTitles": [
              "Any work site",
              "Remote jobs only",
              "Exclude remote jobs",
              "Offers telework"
            ],
            "default": ""
          },
          "relocationAssistance": {
            "title": "Relocation Assistance Only",
            "type": "boolean",
            "description": "Only return postings that reimburse relocation expenses.",
            "default": false
          },
          "minSalary": {
            "title": "Minimum Salary (USD)",
            "type": "integer",
            "description": "Only return postings whose advertised starting salary is at least this amount.",
            "minimum": 0,
            "maximum": 10000000
          },
          "sortBy": {
            "title": "Sort Results",
            "type": "string",
            "description": "Order of returned postings.",
            "editor": "select",
            "enum": [
              "",
              "recentlyPosted",
              "closingSoon",
              "highestSalary",
              "lowestSalary"
            ],
            "enumTitles": [
              "Relevance (default)",
              "Recently posted",
              "Closing soon",
              "Highest salary",
              "Lowest salary"
            ],
            "default": ""
          },
          "includeDetails": {
            "title": "Include Full Job Details",
            "type": "boolean",
            "description": "Fetch each posting's full announcement for duties, qualifications, education, salary range, remote/telework status and clearance. Turn off for a faster, lighter run.",
            "default": true,
            "prefill": false
          },
          "jobUrls": {
            "title": "Job Links or IDs (Job Details mode)",
            "type": "array",
            "description": "In Job Details mode, paste USAJOBS job links (https://www.usajobs.gov/job/123456789) or bare control numbers.",
            "editor": "stringList"
          },
          "maxItems": {
            "title": "Max Items",
            "type": "integer",
            "description": "Maximum number of postings to return.",
            "minimum": 1,
            "maximum": 5000,
            "default": 50,
            "prefill": 2
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "USAJOBS Federal Vacancy & Pay Grade Finder Output",
        "description": "Federal job postings with agency, location, pay scale and grade, salary range, hiring paths, schedule, clearance, duties, qualifications and application deadline.",
        "properties": {
          "jobs": {
            "type": "string",
            "title": "Federal job postings",
            "description": "Dataset containing every scraped federal job posting.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Jobs",
              "transformation": {
                "fields": [
                  "positionTitle",
                  "organizationName",
                  "payScale",
                  "payGradeMin",
                  "payGradeMax",
                  "locationName",
                  "salaryMin",
                  "salaryMax",
                  "applicationCloseDate",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "8bdfd8f39b8510cf48a273553e2c8c8779bb9c896f6b6837cf4475999aec7d1d",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.012494444444444445
    }
  }
}