{
  "openapi": "3.0.1",
  "info": {
    "title": "USAJOBS Federal Jobs Feed: US Government Job Alerts",
    "description": "New US federal government jobs from the official USAJOBS API with your own free key. Filter by keyword, location, remote, GS grade, salary, clearance and hiring path. Scheduled runs return only new jobs, with salary in USD, closing date and the official announcement link. No contact names.",
    "version": "0.1",
    "x-build-id": "mzkjP50ORNsdDe5Zu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fedsignals~usajobs-federal-jobs-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fedsignals-usajobs-federal-jobs-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/fedsignals~usajobs-federal-jobs-feed/runs": {
      "post": {
        "operationId": "runs-sync-fedsignals-usajobs-federal-jobs-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/fedsignals~usajobs-federal-jobs-feed/run-sync": {
      "post": {
        "operationId": "run-sync-fedsignals-usajobs-federal-jobs-feed",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "usajobsApiKey",
          "usajobsEmail"
        ],
        "properties": {
          "usajobsApiKey": {
            "title": "USAJOBS API key",
            "type": "string",
            "description": "Your own free USAJOBS API key. Request one free at https://developer.usajobs.gov/APIRequest/Index (confirm the verification email; the key is emailed to you). It is sent only to USAJOBS, stored encrypted by Apify and never logged or output. Required: without it Apify won't start the run (nothing is charged). A rejected key stops the run before any job is charged."
          },
          "usajobsEmail": {
            "title": "USAJOBS registered email",
            "type": "string",
            "description": "The email address you registered the key with. USAJOBS requires it with every request (as the User-Agent)."
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Comma-separated keywords searched in the job announcement (e.g. data scientist, nurse, cybersecurity). Each keyword is a separate search; results are merged. Max 10. Empty = all jobs."
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Duty locations: 'City, State' (Denver, Colorado), a state name (Virginia), a 2-letter state code (VA) or a country for overseas posts (Japan). Max 20. Empty = anywhere. A misspelled state name fails the run before any job is charged, with a suggestion.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Only jobs USAJOBS marks as fully remote. Telework-eligible jobs are not the same; see the teleworkEligible output field.",
            "default": false
          },
          "gradeMin": {
            "title": "Minimum GS grade",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "Lowest General Schedule (GS) grade, 1-15. Matches jobs whose grade range overlaps your range. Setting a grade keeps only General Schedule jobs (GS, GL, GG, GM) and leaves out wage-grade, SES and other pay plans."
          },
          "gradeMax": {
            "title": "Maximum GS grade",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "Highest GS grade, 1-15. Must not be lower than the minimum."
          },
          "salaryMin": {
            "title": "Minimum salary (USD per year)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Keep jobs whose top of pay range is at least this many US dollars a year. Hourly pay is converted at 2,087 hours a year. Unpaid jobs and jobs without a listed salary are left out when this is set."
          },
          "securityClearance": {
            "title": "Security clearance",
            "type": "array",
            "description": "Only jobs requiring one of these clearances. Empty = any. Checked after download (USAJOBS does not filter clearance itself), so with no keywords or locations over many days only the newest 10,000 jobs are checked.",
            "items": {
              "type": "string",
              "enum": [
                "notRequired",
                "confidential",
                "secret",
                "topSecret",
                "sci",
                "qAccess",
                "lAccess",
                "other"
              ],
              "enumTitles": [
                "Not required",
                "Confidential",
                "Secret",
                "Top Secret",
                "Sensitive Compartmented Information (SCI)",
                "Q access authorization",
                "L access authorization",
                "Other (e.g. public trust)"
              ]
            }
          },
          "hiringPaths": {
            "title": "Who may apply (hiring paths)",
            "type": "array",
            "description": "Only jobs open to at least one of these groups. Choose 'The public' for jobs any US citizen can apply to. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "public",
                "vet",
                "nguard",
                "disability",
                "native",
                "mspouse",
                "student",
                "graduates",
                "ses",
                "peace",
                "overseas",
                "fed-competitive",
                "fed-excepted",
                "fed-internal-search",
                "fed-transition",
                "land",
                "special-authorities"
              ],
              "enumTitles": [
                "The public (US citizens)",
                "Veterans",
                "National Guard & Reserves",
                "Individuals with disabilities",
                "Native Americans",
                "Military spouses",
                "Students",
                "Recent graduates",
                "Senior executives",
                "Peace Corps & AmeriCorps Vista",
                "Family of overseas employees",
                "Federal employees - competitive service",
                "Federal employees - excepted service",
                "Internal to an agency",
                "Career transition (CTAP, ICTAP, RPL)",
                "Land and base management",
                "Special authorities"
              ]
            }
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Only jobs posted in the last N days (1-60). For a daily schedule, 3 gives a safe overlap; onlyNew removes the repeats.",
            "default": 3
          },
          "onlyNew": {
            "title": "Only new jobs (for scheduled runs)",
            "type": "boolean",
            "description": "Return only jobs not delivered by an earlier run with the same filters (or the same state key), so you are never charged twice for the same job. Turn off to get every match each run.",
            "default": true
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many jobs (1-10,000). Each delivered job is one charged event.",
            "default": 100
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Optional name for the onlyNew memory. Use the same key in several tasks to share it, or a new key to start fresh. Empty = derived from your filters."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}