Hiring Cafe job search
A page of job postings from Hiring Cafe for a query, a place and filters.
A page of job postings from Hiring Cafe for a query, a place and filters. Each posting has the
company's own apply link and the record Hiring Cafe makes of it: the company (size, funding,
industries), the place and workplace type, the salary in every period, what is required
(degrees, experience, tools, languages, clearance), the work conditions and the benefits.
A page is 40 groups of postings (a company's same job posted for several places is one group),
21 to 152 postings in all. null means the site does not give it; a false in a benefit
means the site's reading of the posting did not find it, not that the employer has none.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128query?stringWords matched against job titles and the posting.
location?stringA postcode, a town, a state or a country: "78701", "Houston, TX", "Texas", "Canada". A Canadian province or Australian state code is read as the region ("Toronto, ON", "Sydney, NSW"). The site's lookup needs accents ("Montréal"; "Montreal, QC" answers 404). A place the site does not know answers 404. Without it the site searches the country the request is made from.
radius_miles?integerHow far from a town or postcode to look. Ignored for a state or a country.
1 <= value <= 50050workplace_type?|array<>One or several of Remote, Hybrid, Onsite, Field.
commitment?|array<>One or several of Full Time, Part Time, Contract, Internship, Temporary, Seasonal, Volunteer.
seniority?|array<>One or several of No Prior Experience Required, Entry Level, Mid Level, Senior Level.
role_type?|array<>One or both of Individual Contributor, People Manager.
security_clearance?|array<>One or several of None, Confidential, Secret, Top Secret, Top Secret/SCI, Public Trust, Interim Clearances, Other.
date_posted_days?integerOnly postings from the past N days (the site's default is 121).
1 <= value <= 3650salary_min?integerA yearly figure; postings whose lowest listed pay is at least this. Only postings that list their pay are returned.
1 <= valuetransparent_salary_only?booleanOnly postings that list their pay.
falsesort_by?stringOrders the groups of postings (by each group's newest posting for the dates).
"relevance""relevance""date""date_asc""compensation_desc""compensation_asc""experience_asc""experience_desc"page?integer1 <= value <= 2501include_description?booleanAlso fetch each posting's description (one more request each, from the page).
falsemax_descriptions?integerHow many of the page's postings get a description.
1 <= value <= 15040country?stringTwo letters, any case (us, GB).
^[A-Za-z]{2}$The page of postings.
application/json- response
The first three keys of every parsed 200 (the answer is the document itself, no success/data
envelope): what the search was (search_metadata), what it asked (search_parameters), the
parser's own search_information ({} when it has none). The engine's blocks follow, at the same
level. An engine whose answer is a list puts it under results.
search_metadata*search_parameters*The request's own fields as sent, engine first, without cancel_token.
search_information*The parser's own, e.g. yelp_search's; otherwise {}.
jobs_results?array<>pagination?curl -X GET 'https://api.justserp.com/v1/hiringcafe/jobs?query=nurse&location=Houston%2C+TX&commitment=Full+Time'{ "search_metadata": { "id": "string", "status": "Success", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": { "title": "string", "query": "string", "locations": [ { "name": "string", "type": "string", "latitude": 0, "longitude": 0, "radius_miles": 0, "is_default": true } ], "filters": {}, "total_results": 0, "company_count": 0, "jobs_on_page": 0, "sponsored_on_page": 0, "groups_on_page": 0, "applied_suggestion": {} }, "jobs_results": [ { "position": 0, "job_id": "string", "title": "string", "title_raw": "string", "core_title": "string", "apply_link": "string", "source": "string", "sponsored": true, "board_token": "string", "source_job_id": "string", "requisition_id": "string", "company": { "name": "string", "website": "string", "tagline": "string", "sector": "string", "industries": [ "string" ], "activities": [ "string" ], "organization_type": "string", "employee_count": 0, "year_founded": 0, "headquarters_country": "string", "parent_company": "string", "subsidiaries": [ "string" ], "aliases": [ "string" ], "stock": { "exchange": "string", "symbol": "string" }, "funding": { "type": "string", "amount": 0, "year": 0, "lead_investors": [ "string" ] }, "employer_type": "string", "board_classification": "string", "entity_id": "string", "external_id": "string", "attributed_by": "string" }, "location": { "text": "string", "workplace_type": "Remote", "cities": [ "string" ], "counties": [ "string" ], "states": [ "string" ], "countries": [ "string" ], "continents": [ "string" ], "coordinates": { "latitude": 0, "longitude": 0 }, "all_coordinates": [ {} ], "anywhere_in_world": true, "other_locations": [ "string" ] }, "posted_at": "string", "posted_at_timestamp": 0, "commitment": [ "string" ], "seniority_level": "string", "role_type": "string", "job_category": "string", "salary": { "currency": "string", "period": "string", "min": 0, "max": 0, "is_transparent": true, "per_hour": { "min": 0, "max": 0 }, "per_day": { "min": 0, "max": 0 }, "per_week": { "min": 0, "max": 0 }, "per_two_weeks": { "min": 0, "max": 0 }, "per_month": { "min": 0, "max": 0 }, "per_year": { "min": 0, "max": 0 } }, "requirements": { "summary": "string", "min_years_experience": 0, "min_years_management": 0, "high_school_required": true, "education": { "associates": { "requirement": "Required", "fields_of_study": [ "string" ] }, "bachelors": { "requirement": "Required", "fields_of_study": [ "string" ] }, "masters": { "requirement": "Required", "fields_of_study": [ "string" ] }, "doctorate": { "requirement": "Required", "fields_of_study": [ "string" ] } }, "licenses_or_certifications": [ "string" ], "languages": [ "string" ], "security_clearance": "string", "technical_tools": [ "string" ], "role_activities": [ "string" ], "driver_license_required": true }, "work_conditions": { "physical_environment": "string", "physical_labor_intensity": "string", "physical_position": "string", "oral_communication": "string", "computer_usage": "string", "cognitive_demand": "string", "air_travel": "string", "land_travel": "string", "on_call": "string", "overtime_required": true, "weekend_availability_required": true, "holiday_availability_required": true, "morning_shift": "string", "evening_shift": "string", "overnight_work": "string" }, "benefits": { "retirement_plan": true, "matching_401k": true, "generous_paid_time_off": true, "generous_parental_leave": true, "tuition_reimbursement": true, "relocation_assistance": true, "four_day_work_week": true, "visa_sponsorship": true, "fair_chance": true, "military_veterans": true }, "stats": { "views": 0, "applies": 0, "saves": 0 }, "is_expired": true, "group": { "key": "string", "position": 0, "size": 0 }, "other_postings": [ { "job_id": "string", "source": "string", "board_token": "string", "requisition_id": "string", "apply_link": "string", "location": "string", "rank": 0 } ], "description": "string", "description_markdown": "string", "description_html": "string", "extra": { "job_incarnation": 0 } } ], "pagination": { "current_page": 0, "groups_per_page": 0, "is_last_page": true, "next_page": 0, "total_results": 0 }}DuckDuckGo Maps GET
The places DuckDuckGo lists for a query in an area, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `local_results` and `place_result`.
Hiring Cafe job description GET
The description of one Hiring Cafe posting, as the company wrote it (HTML), as text and as markdown.