Company Profiles for the Employers Behind the Jobs
A job posting tells you the role. It rarely tells you who you would be working for: a 40-person startup or a 40,000-person bank, a software company or a logistics firm. Jobven's company profiles answer that. Most employers behind a job have a profile read from their own website: what the company does, its industry, an employee count band, the year it was founded, where it is headquartered, and its LinkedIn, X and GitHub pages.
Who it is for
- Job boards filter employers by size and industry, and show a one-line "what this company does" beside each job.
- Sales and market research teams find companies of a given size and industry that are hiring now, which is a buying signal.
- Career sites and newsletters link each job to a short company card.
- AI assistants answer "is this a startup?" from data, through the Jobven MCP server.
Filter companies by industry and size
Profiles take the same industry keys as jobs, so technology_software means the same thing on both. Employee count is a band (51-200, 201-500, and so on up to 10001+), and minEmployees and maxEmployees match any band that overlaps your range:
# Software companies with 200 to 1,000 employees
curl -H "X-API-Key: $JOBVEN_API_KEY" \
"https://api.jobven.com/v1/public/company-profiles?industry=technology_software&minEmployees=200&maxEmployees=1000"
{
"id": 1042,
"name": "TechCorp Inc.",
"description": "TechCorp makes payroll and scheduling software for restaurants.",
"industry": "technology_software",
"size": "201-500",
"sizeSource": "stated",
"foundedYear": 2014,
"headquarters": { "city": "Toronto", "state": "Ontario", "country": "CA" },
"linkedinUrl": "https://www.linkedin.com/company/techcorp"
}
A company whose size is not known is left out when you filter on employee count. Add includeUnknownSize=true to keep those companies in the results as well.
From a job to its company in one call
Every job lists its companies with an id, so you can fetch the company's profile when you need it:
const headers = { 'X-API-Key': process.env.JOBVEN_API_KEY };
const jobs = await fetch(
'https://api.jobven.com/v1/public/jobs?q=engineer&country=CA',
{ headers }
).then((r) => r.json());
const company = await fetch(
`https://api.jobven.com/v1/public/company-profiles/${jobs.data[0].companies[0].id}`,
{ headers }
).then((r) => r.json());
console.log(company.name, company.size, company.foundedYear);
Each profile returned counts one toward your monthly allowance, the same as a job. Finding companies by name with /v1/public/companies is free.
Where the data comes from
Each company's own website, read again every 90 days. Founding years, headquarters and social links are taken from the site as written: from its structured data, or from a sentence on its about page that states them. If the site does not say, the field is null; Jobven does not guess a founding year. The description is written by a model from the site's own pages, in plain words.
Industry and an estimated size are classified by a model from the same pages, and the API says which size is which: sizeSource is stated when the company's site gives its head count, and estimated otherwise. Checked against public sources on 79 companies before launch, estimated bands were the exact band 71% of the time and within one band 97% of the time, and founding years were right 33 times in 35.
Most companies with open jobs have a description, an industry and a size band. A founding year, headquarters and social links appear when the company's own site states them, so each field follows what the company publishes about itself.
What this removes
No separate company data provider to license, no matching their company names to the employers in your job feed, and no second integration to maintain. The companies behind the jobs come with the jobs, under the same key. The companies API reference lists every field and filter.