ReqHunt APIreqhunt.com ↗
Access ReqHunt's tracked company directory and live job postings via two endpoints. Filter jobs by title and location across companies with active careers pages.
What is the ReqHunt API?
The ReqHunt API exposes two endpoints covering a directory of tracked companies and their live job postings. Call list_companies to page through companies ordered by open role count, then call search_company_jobs with a company slug to retrieve postings filtered by job title and location — each posting returning fields like job_url, department, location, and posted_at timestamp.
curl -X GET 'https://api.parse.bot/scraper/49f2e024-0e95-48cd-a97d-5d81fd85de98/list_companies' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace reqhunt-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: ReqHunt Jobs API — browse top companies, then search one's postings."""
from parse_apis.reqhunt_com_api import ReqHunt, CompanyNotFound
client = ReqHunt()
# Browse the top companies by open roles.
for company in client.companies.list(limit=5):
print(company.rank, company.name, company.open_roles, company.work_mode)
# Pick the first company and search its engineering jobs.
top = client.companies.list(limit=1).first()
if top is not None:
try:
result = top.search_jobs(title="engineer")
except CompanyNotFound:
print("company no longer tracked")
else:
print(f"Searching {result.company.name} — {result.company.total_roles} total roles")
for job in result.jobs:
print(job.title, job.location, job.posted_at)
# Continue scanning from the next offset if more results exist.
if result.next_start is not None:
more = top.search_jobs(title="engineer", start=result.next_start)
for job in more.jobs:
print(job.title, job.location)
print("exercised: companies.list / search_jobs")
Returns one page (100 rows) of the public company directory, ordered by number of live open roles (descending). Each row carries the company's display name and its slug, which is the identifier search_company_jobs accepts as company. remote_index_tier and work_mode are null for companies the site has not scored. One request per call; page beyond total_pages returns an empty companies array with has_more=false. Omitting page returns the first page.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based directory page number (100 companies per page). |
{
"type": "object",
"fields": {
"page": "integer page returned",
"has_more": "boolean, true when a later page exists",
"companies": "array of company rows: rank (integer position in the directory), name, slug (pass as company to search_company_jobs), open_roles (integer live roles), remote_index_tier (e.g. R0, or null when unscored), work_mode (e.g. On-Site, or null when unscored)",
"total_pages": "integer number of directory pages",
"total_companies": "integer number of companies tracked"
},
"sample": {
"data": {
"page": 1,
"has_more": true,
"companies": [
{
"name": "SpaceX",
"rank": 1,
"slug": "spacex",
"work_mode": "On-Site",
"open_roles": 2426,
"remote_index_tier": "R0"
},
{
"name": "Anduril Industries",
"rank": 2,
"slug": "anduril-industries",
"work_mode": null,
"open_roles": 2276,
"remote_index_tier": null
}
],
"total_pages": 76,
"total_companies": 7594
},
"status": "success"
}
}About the ReqHunt API
Company Directory
list_companies returns one page of 100 companies at a time, ordered by number of live open roles descending. Each row includes the company name, its slug (the identifier used in search_company_jobs), and open_roles count. The response also carries total_companies, total_pages, and a has_more boolean so you can walk the full directory programmatically using the page parameter.
Job Postings Search
search_company_jobs scans a single company's live postings and returns matches against optional title and location substring filters (both case-insensitive). Each matching posting in the jobs array includes title, job_url, location, department, company, posted_at (ISO 8601 UTC), and posted_text. The company object in the response surfaces the careers page URL (careers_page_url), total_roles, and pagination metadata for the source listing.
Pagination and Scanning
The endpoint uses offset-based pagination via start (0-based) and limit (capped at 50). A next_start field in the response gives you the offset to pass in the next call; it returns null when the list is exhausted. Each call reports scanned (postings examined) and pages_scanned (capped at 5 per call), which helps you understand how much of the company's listing was covered in a single request.
The ReqHunt API is a managed, monitored endpoint for reqhunt.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when reqhunt.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official reqhunt.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a job alert tool that watches a specific company's postings for new titles matching a keyword.
- Rank companies by hiring velocity using the
open_rolesfield fromlist_companies. - Filter postings by location substring (e.g. 'remote' or 'new york') to surface roles in a target geography.
- Aggregate department-level hiring data across companies by collecting the
departmentfield from job results. - Identify which companies have active careers pages by checking
careers_page_urlinsearch_company_jobsresponses. - Track changes in a company's
total_rolescount over time to monitor hiring trends. - Cross-reference
posted_attimestamps across companies to find the most recently listed roles in a given field.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ReqHunt have an official developer API?+
What does `search_company_jobs` return for each posting?+
jobs array includes title, job_url, location, department, posted_at (ISO 8601 UTC timestamp), posted_text, and the company name and slug. The enclosing company object adds careers_page_url, total_roles, and paginator metadata for that company's listing.Can I search jobs across all companies at once rather than one company at a time?+
search_company_jobs targets one company per call, identified by the company slug parameter. Cross-company search would require iterating the directory via list_companies and querying each slug. You can fork this API on Parse and revise it to add a multi-company search endpoint.Does the API expose salary or compensation data for job postings?+
title, location, department, job_url, and timestamps, but no salary or compensation fields. You can fork this API on Parse and revise it to add compensation data if the source careers pages expose it.How fresh are the job postings returned by the API?+
posted_at field gives the ISO 8601 UTC timestamp of when each role was posted, which helps you assess recency. Listings that have been taken down will not appear in results.