Fetch one cleared job. query is the job URL from search or the slug, for example analyst-washington-district-of-columbia-1902823. The slug ends with the numeric id. The response is a flat object. security_clearance on this record comes from the posting, and description is the full text.
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/clearedjobs/job?query=analyst-washington-district-of-columbia-1902823"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/clearedjobs/job?query=https%3A%2F%2Fclearedjobs.net%2Fjob%2Fanalyst-washington-district-of-columbia-1902823"
| Name |
Detail |
| query |
Required string. Job URL or slug ending in the numeric id. Example: analyst-washington-district-of-columbia-1902823. |
| Name |
Detail |
| id |
String. Same id as the search card. |
| title |
String. |
| description |
String or null. Posting text. |
| company |
String or null. |
| company_url |
String or null. |
| company_logo |
String or null. |
| location |
String or null. City, region, and country joined. |
| city |
String or null. |
| region |
String or null. |
| country |
String or null. |
| postal_code |
String or null. |
| security_clearance |
String or null. |
| employment_type |
String or null. |
| date_posted |
String or null. ISO timestamp from the posting. |
| valid_through |
String or null. |
| url |
String. Job URL. |
One job. No pagination object. Search does not provide a next page to walk.
- A recruiter opens the slug from search and reads
description plus security_clearance.
- A CRM stores
city, region, company, and company_url for the same id as the search card.
- An alert watches
date_posted and employment_type for one posting URL.
| Name |
Detail |
| 400 |
Missing query, a host other than clearedjobs.net, or a value that is not a job URL or slug. |
| 404 |
Job page had no posting. |
| 401 |
Missing API key. |
| 500 |
The ClearedJobs request failed. |
