> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /usajobs/jobs/search

> Search open US federal government job announcements on USAJOBS by keyword, location and the full set of site filters: radius, exact job titles, salary range, pay plan, hiring path (who can apply), appointment type, supervisory status, work schedule, travel percentage, security clearance, occupational series, cyber workforce role and grouping, department and agency (include or exclude), and remote/telework work site. Results can be ordered by relevance, posting date, closing date or salary. Each item carries the control number (id), announcement number, title, URL, department/agency/sub-agency, salary, locations, schedule, appointment type, pay scale and grade range, relocation flag, open period, posting and closing timestamps, hiring paths and occupational series.

**Price:** 5 credits per 100 results



## OpenAPI

````yaml /openapi/jobs.json post /api/usajobs/jobs/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/usajobs/jobs/search:
    post:
      tags:
        - /usajobs
      summary: /usajobs/jobs/search
      description: >-
        Search open US federal government job announcements on USAJOBS by
        keyword, location and the full set of site filters: radius, exact job
        titles, salary range, pay plan, hiring path (who can apply), appointment
        type, supervisory status, work schedule, travel percentage, security
        clearance, occupational series, cyber workforce role and grouping,
        department and agency (include or exclude), and remote/telework work
        site. Results can be ordered by relevance, posting date, closing date or
        salary. Each item carries the control number (id), announcement number,
        title, URL, department/agency/sub-agency, salary, locations, schedule,
        appointment type, pay scale and grade range, relocation flag, open
        period, posting and closing timestamps, hiring paths and occupational
        series.


        **Price:** 5 credits per 100 results
      operationId: __api_usajobs_jobs_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UsajobsJobsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UsajobsJobSearchResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    UsajobsJobsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        keyword:
          anyOf:
            - type: string
            - type: 'null'
        location:
          anyOf:
            - type: string
            - type: 'null'
        radius:
          anyOf:
            - $ref: '#/components/schemas/UsajobsSearchRadius'
            - type: 'null'
        job_title:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        min_salary:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_salary:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        pay_plan:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        hiring_path:
          anyOf:
            - items:
                $ref: '#/components/schemas/UsajobsHiringPath'
              type: array
            - type: 'null'
        appointment_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/UsajobsAppointmentType'
              type: array
            - type: 'null'
        is_supervisory:
          anyOf:
            - type: boolean
            - type: 'null'
        work_schedule:
          anyOf:
            - items:
                $ref: '#/components/schemas/UsajobsWorkSchedule'
              type: array
            - type: 'null'
        travel_percentage:
          anyOf:
            - items:
                $ref: '#/components/schemas/UsajobsTravelPercentage'
              type: array
            - type: 'null'
        security_clearance:
          anyOf:
            - items:
                $ref: '#/components/schemas/UsajobsSecurityClearance'
              type: array
            - type: 'null'
        job_series:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        cyber_work_role:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        cyber_work_grouping:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        department:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        agency:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        exclude_organizations:
          type: boolean
          default: false
        work_site:
          anyOf:
            - $ref: '#/components/schemas/UsajobsWorkSite'
            - type: 'null'
        sort_by:
          $ref: '#/components/schemas/UsajobsSortBy'
          default: relevance
        count:
          type: integer
          minimum: 1
      type: object
      required:
        - count
    UsajobsJobSearchResult:
      properties:
        '@type':
          type: string
          default: UsajobsJobSearchResult
        id:
          type: string
        announcement_number:
          anyOf:
            - type: string
            - type: 'null'
        job_title:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        department:
          anyOf:
            - type: string
            - type: 'null'
        agency:
          anyOf:
            - type: string
            - type: 'null'
        sub_agency:
          anyOf:
            - type: string
            - type: 'null'
        salary_display:
          anyOf:
            - type: string
            - type: 'null'
        salary_min:
          anyOf:
            - type: number
            - type: 'null'
        location:
          anyOf:
            - type: string
            - type: 'null'
        location_display:
          anyOf:
            - type: string
            - type: 'null'
        location_name:
          anyOf:
            - type: string
            - type: 'null'
        location_count:
          anyOf:
            - type: integer
            - type: 'null'
        work_schedule:
          anyOf:
            - type: string
            - type: 'null'
        appointment_type:
          anyOf:
            - type: string
            - type: 'null'
        pay_scale:
          anyOf:
            - type: string
            - type: 'null'
        low_grade:
          anyOf:
            - type: string
            - type: 'null'
        high_grade:
          anyOf:
            - type: string
            - type: 'null'
        is_relocation_reimbursed:
          anyOf:
            - type: boolean
            - type: 'null'
        announcement_closing_type:
          anyOf:
            - type: string
            - type: 'null'
        announcement_closing_option:
          anyOf:
            - type: string
            - type: 'null'
        open_period_display:
          anyOf:
            - type: string
            - type: 'null'
        posted_display:
          anyOf:
            - type: string
            - type: 'null'
        starts_at:
          anyOf:
            - type: integer
            - type: 'null'
        ends_at:
          anyOf:
            - type: integer
            - type: 'null'
        hiring_paths:
          items:
            $ref: '#/components/schemas/UsajobsJobHiringPath'
          type: array
          default: []
        job_series:
          items:
            $ref: '#/components/schemas/UsajobsJobSeries'
          type: array
          default: []
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    UsajobsSearchRadius:
      type: string
      enum:
        - '5'
        - '10'
        - '25'
        - '50'
        - '100'
    UsajobsHiringPath:
      type: string
      enum:
        - public
        - fed-competitive
        - fed-excepted
        - fed-internal-search
        - fed-transition
        - land
        - vet
        - mspouse
        - nguard
        - student
        - graduates
        - ses
        - disability
        - overseas
        - native
        - peace
        - special-authorities
    UsajobsAppointmentType:
      type: string
      enum:
        - '15320'
        - '15522'
        - '15328'
        - '15327'
        - '15317'
        - '15326'
        - '15322'
        - '15323'
        - '15318'
        - '15321'
        - '15319'
    UsajobsWorkSchedule:
      type: string
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
    UsajobsTravelPercentage:
      type: string
      enum:
        - '0'
        - '1'
        - '2'
        - '5'
        - '7'
        - '8'
    UsajobsSecurityClearance:
      type: string
      enum:
        - '0'
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '7'
        - '8'
    UsajobsWorkSite:
      type: string
      enum:
        - remote
        - telework
    UsajobsSortBy:
      type: string
      enum:
        - relevance
        - recently_posted
        - closing_soon
        - highest_salary
        - lowest_salary
    UsajobsJobHiringPath:
      properties:
        '@type':
          type: string
          default: UsajobsJobHiringPath
        code:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - code
    UsajobsJobSeries:
      properties:
        '@type':
          type: string
          default: UsajobsJobSeries
        code:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - code
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````