PHPackages                             jobapis/jobs-govt - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. jobapis/jobs-govt

ActiveLibrary

jobapis/jobs-govt
=================

Making it simple to integrate your application with the Government Jobs API.

1.0.1(7y ago)63.3k↓100%4[1 issues](https://github.com/jobapis/jobs-govt/issues)1Apache-2.0PHPPHP >=5.5.0

Since Apr 16Pushed 7y ago3 watchersCompare

[ Source](https://github.com/jobapis/jobs-govt)[ Packagist](https://packagist.org/packages/jobapis/jobs-govt)[ Docs](https://github.com/jobapis/jobs-govt)[ RSS](/packages/jobapis-jobs-govt/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (14)Used By (1)

Government Jobs Client
======================

[](#government-jobs-client)

[![Latest Version](https://camo.githubusercontent.com/3f3c0181551f1d197945d36e1934cc0ad6d69c6de8cfd5e08c5688bbecd1c536/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6a6f62617069732f6a6f62732d676f76742e7376673f7374796c653d666c61742d737175617265)](https://github.com/jobapis/jobs-govt/releases)[![Software License](https://camo.githubusercontent.com/83a69279c9f2ed137be556c08d1ceaf2161ae96eeb88f8caade8ef619f2d6c27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d415041434845253230322e302d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/135caff0cc3dbfb71bae9925f33f19d10afa0668bb8f1639553e8f44f9305815/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6a6f62617069732f6a6f62732d676f76742f6d61737465722e7376673f7374796c653d666c61742d7371756172652631)](https://travis-ci.org/jobapis/jobs-govt)[![Coverage Status](https://camo.githubusercontent.com/241ea69c065d8148091a8c38113724650f744947518e1de7cccbe6366f1b1fec/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f6a6f62617069732f6a6f62732d676f76742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/jobapis/jobs-govt/code-structure)[![Quality Score](https://camo.githubusercontent.com/1b6fe3b337f62d7c7806a0d52935b4d13043e484eb11f73ab23ee06199b34b9b/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6a6f62617069732f6a6f62732d676f76742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/jobapis/jobs-govt)[![Total Downloads](https://camo.githubusercontent.com/60854334b05fe76e12ed7d87f5dd3d4b77e9e0a6f886269b7315cd5e33ddea63/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f62617069732f6a6f62732d676f76742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jobapis/jobs-govt)

This package provides [Government Jobs API](http://search.digitalgov.gov/developer/jobs.html)support for the [Jobs Common Project](https://github.com/jobapis/jobs-common).

Installation
------------

[](#installation)

To install, use composer:

```
composer require jobapis/jobs-govt

```

Usage
-----

[](#usage)

Create a Query object and add all the parameters you'd like via the constructor.

```
// Add parameters to the query via the constructor
$query = new JobApis\Jobs\Client\Queries\GovtQuery([
    'hl' => '1'
]);
```

Or via the "set" method. All of the parameters documented in the API's documentation can be added.

```
// Add parameters via the set() method
$query->set('query', 'engineering');
```

You can even chain them if you'd like.

```
// Add parameters via the set() method
$query->set('size', '100')
    ->set('from', '200');
```

*Note: The government jobs API doesn't support adding location as a parameter, but their keyword or lat\_lon parameters can be used for this purpose.*

Then inject the query object into the provider.

```
// Instantiating provider with a query object
$client = new JobApis\Jobs\Client\Provider\GovtProvider($query);
```

And call the "getJobs" method to retrieve results.

```
// Get a Collection of Jobs
$jobs = $client->getJobs();
```

This will return a [Collection](https://github.com/jobapis/jobs-common/blob/master/src/Collection.php) of [Job](https://github.com/jobapis/jobs-common/blob/master/src/Job.php) objects.

Testing
-------

[](#testing)

```
$ ./vendor/bin/phpunit
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/jobapis/jobs-govt/blob/master/CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Steven Maguire](https://github.com/stevenmaguire)
- [Karl Hughes](https://github.com/karllhughes)
- [All Contributors](https://github.com/jobapis/jobs-govt/contributors)

License
-------

[](#license)

The Apache 2.0. Please see [License File](https://github.com/jobapis/jobs-govt/blob/master/LICENSE) for more information.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~101 days

Recently: every ~274 days

Total

13

Last Release

2826d ago

Major Versions

0.6.0 → 1.0.0-alpha2016-09-02

PHP version history (2 changes)0.1.0PHP >=5.4.0

0.4.1PHP >=5.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8f48fe8aced156a4651617032e4d126d7e3f696e46539688b3bda792d28ee0b4?d=identicon)[karllhughes](/maintainers/karllhughes)

---

Top Contributors

[![karllhughes](https://avatars.githubusercontent.com/u/1103622?v=4)](https://github.com/karllhughes "karllhughes (51 commits)")[![hassanmehmoodpl](https://avatars.githubusercontent.com/u/19727591?v=4)](https://github.com/hassanmehmoodpl "hassanmehmoodpl (3 commits)")

---

Tags

objectapi clientjobsgovernment jobs

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/jobapis-jobs-govt/health.svg)

```
[![Health](https://phpackages.com/badges/jobapis-jobs-govt/health.svg)](https://phpackages.com/packages/jobapis-jobs-govt)
```

###  Alternatives

[jobapis/jobs-indeed

Making it simple to integrate your application with Indeed Jobs API.

2635.2k1](/packages/jobapis-jobs-indeed)[jobapis/jobs-common

Making it simple to integrate your application with job api providers.

4459.3k32](/packages/jobapis-jobs-common)[jobapis/jobs-ziprecruiter

Making it simple to integrate your application with ZipRecruiter Jobs API.

134.9k1](/packages/jobapis-jobs-ziprecruiter)[jobapis/jobs-stackoverflow

Making it simple to integrate your application with Stack Overflows's Career RSS Feed.

162.7k1](/packages/jobapis-jobs-stackoverflow)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)