RTIFilters

Filters that are used to narrow the search of job posting data.

NameDescriptionSupported Filter Types
occOccupation. Use SOC codes as keys. Note: only IS filters are supported for this fieldIs
compCompany, or "Employer"Is, Contains
locLocation published in job post. Note: this is district from the assigned location used by the regions parameter.Is, Contains
certRequired certificationsIs, Contains
titlePublished job titleIs, Contains
degreeTypeRequired degree level. Note: only IS filters are supported for this fieldIs
programRequired educational programsIs, Contains
hardSkillsRequired hard skillsIs, Contains
softSkillsRequired soft skillsIs, Contains
jobTypePublished job type. Note: only IS filters are supported for this fieldIs

RTI FilterType

NameDescription
IsThe field value has to match the key exactly
ContainsThe field value has to contain the key
NotThe field value does not match the key exactly
NotContainsThe field value does not contain the key

Query Parameter Examples

Return the 100 most recent active job postings that include the title 'Registered Nurses' in Chicago.

{
    "regions": [{
        "type": "MSA",
        "code": 1698
    }],
    "filters": [{
        "field": "title",
        "key": "Registered Nurse",
        "filterType": "Contains"
    }],
    "excludeStaffing": false,
    "postState": "CurrentActive"
}
$query = [
   "regions" => [
         [
            "type" => "MSA", 
            "code" => 1698 
         ] 
      ], 
   "filters" => [
               [
                  "field" => "title", 
                  "key" => "Registered Nurse", 
                  "filterType" => "Contains" 
               ] 
            ], 
   "excludeStaffing" => false, 
   "postState" => "CurrentActive" 
]; 

Return the 1000 most recent active job postings that have match the Standard Occupational Classification (SOC) code for Security Guards (33-9032) in California and Nevada.

{
    "regions": [{
        "type": "State",
        "code": 6
    }, {
        "type": "State",
        "code": 32
    }],
    "filters": [{
        "field": "occ",
        "key": "33-9032",
        "filterType": "Is"
    }],
    "excludeStaffing": false,
    "postState": "CurrentActive",
    "startRecord": 0,
    "endRecord": 1000
}
 $query = [
   "regions" => [
         [
            "type" => "State", 
            "code" => 6 
         ], 
         [
               "type" => "State", 
               "code" => 32 
            ] 
      ], 
   "filters" => [
                  [
                     "field" => "occ", 
                     "key" => "33-9032", 
                     "filterType" => "Is" 
                  ] 
               ], 
   "excludeStaffing" => false, 
   "postState" => "CurrentActive", 
   "startRecord" => 0, 
   "endRecord" => 1000 
]; 

Return the most recent, currently active job postings in Reading, PA for Legal Occupations - but filter out job postings for Lawyers.

{
    "regions": [{
        "type": "MSA",
        "code": 3974
    }],
    "filters": [{
            "field": "occ",
            "key": "23-0000", // Legal Occupations (23-0000)
            "filterType": "IS"
        },
        {
            "field": "occ",
            "key": "23-1011", // Lawyers (23-1011)
            "filterType": "NOT"
        }
    ],
    "excludeStaffing": true,
    "postState": "CurrentActive",
    "startRecord": 0,
    "endRecord": 1000
}
 $query = [
    "regions" => [
        [
            "type" => "MSA",
            "code" => 3974
        ]
    ],
    "filters" => [
        [   
            // Legal Occupations (23-0000)
            "field" => "occ",
            "key" => "23-0000", 
            "filterType" => "IS"
        ],
        [
            // Lawyers (23-1011)
            "field" => "occ",
            "key" => "23-1011", 
            "filterType" => "NOT"
        ]
    ],
    "excludeStaffing" => true,
    "postState" => "CurrentActive",
    "startRecord" => 0,
    "endRecord" => 1000
];

Return the first 1000 job postings containing the skill "Java" that were posted in Cook and DuPage counties in Illinois during the last year from Feb 29, 2024.

{
    "regions": [{
        "type": "County",
        "code": 17031
    }, {
        "type": "County",
        "code": 17043
    }],
    "filters": [{
        "field": "hardSkills",
        "key": "Java",
        "filterType": "CONTAINS"
    }],
    "excludeStaffing": false,
    "postState": "Active",
    "start": "2023-02-28T05:00:00Z",
    "end": "2024-02-29T05:00:00Z",
    "startRecord": 0,
    "endRecord": 1000
}

 $query = [
    "regions" => [
        [
            "type" => "County",
            "code" => 17031
        ],
        [
        	  "type" => "County",
            "code" => 17043
        ]
    ],
    "filters" => [
        [   
            "field" =>  "hardSkills",
        		"key" => "Java",
        		"filterType" =>  "CONTAINS"
        ]
    ],
    "excludeStaffing" => true,
    "postState" => "Active",
    "start" => "2023-02-28T05:00:00Z",
    "end" => "2024-02-29T05:00:00Z",
    "startRecord" => 0,
    "endRecord" => 1000
];