# Personnel.com

> Personnel.com is an American online job board connecting job seekers with employers. Job seekers can browse open positions, publish resumes, and apply to listings; employers can post jobs and search candidate resumes.

Public, machine-readable resources are exposed at well-known URLs so agents can navigate the site without scraping HTML.

## Discovery

- [Sitemap index](https://personnel.com/sitemap.xml): XML index of every per-section sitemap (jobs, companies, categories, statics).
- [robots.txt](https://personnel.com/robots.txt): Crawler policy and Content-Signal AI usage preferences.
- [API catalog](https://personnel.com/.well-known/api-catalog): RFC 9727 linkset enumerating canonical resource URLs.

## Primary content

- [Jobs](https://personnel.com/jobs): Open job listings. Individual listings at `/jobs/{slug}` emit `schema.org/JobPosting` JSON-LD.
- [Companies](https://personnel.com/companies): Hiring company profiles.
- [Categories](https://personnel.com/categories): Job categories.

## JSON API (public, unauthenticated, rate-limited 30 req/min per IP)

- **OpenAPI 3.1 spec:** [`https://personnel.com/docs/api.json`](https://personnel.com/docs/api.json) — machine-readable contract for code generation.
- **Interactive docs:** [`https://personnel.com/docs/api`](https://personnel.com/docs/api).
- **CORS:** all origins, GET/HEAD/OPTIONS, no credentials.
- **HTTP caching:** every response carries `ETag` and `Cache-Control: public, max-age=60`. Send `If-None-Match` for 304s.

Endpoints:

- `GET https://personnel.com/api/v1/jobs` — paginated published jobs. Filters: `?q={search}`, `?category={id}`, `?company={slug}`, `?sort=-created_at|salary|updated_at`, `?per_page=1..50`.
- `GET https://personnel.com/api/v1/jobs/{slug}` — single job (published, non-expired, non-flagged).
- `GET https://personnel.com/api/v1/companies` — paginated companies. `?q={search}`, `?sort=-created_at|name|updated_at`, `?per_page=1..50`.
- `GET https://personnel.com/api/v1/companies/{slug}` — single company.
- `GET https://personnel.com/api/v1/categories` — all categories with published-job counts.
- `GET https://personnel.com/api/v1/categories/{id}` — single category.

## Agent affordances

- Markdown content negotiation: send `Accept: text/markdown` on any HTML page to receive a markdown rendering with `Content-Type: text/markdown` and a `Vary: Accept` header.
- RFC 8288 `Link` response headers on the homepage advertise the sitemap, robots.txt, and api-catalog.

## Site info

- Homepage: https://personnel.com/
- Contact: https://personnel.com/info/contact
- Legal: https://personnel.com/info/legal