Search cleared jobs on clearedjobs.net. query is a keyword, a jobs URL with keywords, or a page such as q-analyst-jobs.html. A job URL (/job/...) returns 400. Use the job endpoint for that URL.
Only the first HTML page is available. pagination.next is null even when total_results is larger than the cards returned. Do not invent a next URL. page above 1 returns 404. total_pages is null.
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/clearedjobs/search?query=analyst"
| Name |
Detail |
| query |
Required string. Keyword or a clearedjobs.net jobs URL. Example: analyst. A job URL returns 400. |
| page |
Optional integer. Only page 1 is served. Example: 1. page=2 returns 404. |
| Name |
Detail |
| results[].id |
String. Job id. The slug on url ends with this id. |
| results[].title |
String. |
| results[].url |
String. Pass this URL to the job endpoint. |
| results[].company |
String or null. |
| results[].location |
String or null. |
| results[].security_clearance |
String or null. For example Public Trust. |
| results[].posted |
String or null. Display date from the card, for example October 16, 2026. |
| results[].logo |
String or null. |
| pagination.page |
Integer. Always 1 on a successful search. |
| pagination.per_page |
Integer. Number of cards in this HTML page. |
| pagination.total_results |
Integer or null. The Found N Jobs count. It can be much larger than per_page. |
| pagination.total_pages |
Null. Further pages are not in the HTML. |
| pagination.next |
Null. There is no next URL to follow. |
next is null because only the first HTML page is available. That is true even when total_results is in the thousands and per_page is about 25. total_pages is null. Requesting page=2 returns 404. Ids on the page are unique. Open each url with the job endpoint for the posting text.
- A cleared staffing desk lists the first page of
analyst roles and reads security_clearance on each card.
- A job board passes every
url to the job endpoint. It does not request page 2.
- A market scan stores
total_results as the site's found count and treats the returned cards as the only page.
| Name |
Detail |
| 400 |
Missing query, a host other than clearedjobs.net, or a job URL sent to search. |
| 404 |
No jobs, or page above 1. |
| 401 |
Missing API key. |
| 500 |
The ClearedJobs request failed. |
