Companies
Retrieve company information and profiles from the Jobven API.
The Companies endpoint lets you retrieve company information and profiles.
List Companies
GET /v1/public/companies
Returns a paginated list of companies.
Note: Companies use offset pagination (
page/limit) instead of cursor pagination.curl -H "X-API-Key: $JOBVEN_API_KEY" \
"https://api.jobven.com/v1/public/companies?search=tech&limit=20"
const response = await fetch(
'https://api.jobven.com/v1/public/companies?search=tech&limit=20',
{ headers: { 'X-API-Key': process.env.JOBVEN_API_KEY } }
);
const companies = await response.json();
import requests
import os
response = requests.get(
'https://api.jobven.com/v1/public/companies',
headers={'X-API-Key': os.environ['JOBVEN_API_KEY']},
params={'search': 'tech', 'limit': 20}
)
companies = response.json()
Query Parameters
| Parameter | Type | Description |
|---|---|---|
search | string | Search by company name or description |
industry | string | Filter by industry (e.g., Technology) |
size | string | Filter by company size (e.g., 51-200) |
isVerified | boolean | Filter by verification status |
status | enum | active, inactive |
sortBy | enum | name, foundedYear, totalJobsPosted, activeJobsCount, createdAt |
sortOrder | enum | ASC, DESC |
page | number | Page number (starts at 1) |
limit | number | Results per page |
Response
[
{
"name": "TechCorp Inc.",
"website": "https://techcorp.com"
},
{
"name": "StartupXYZ",
"website": "https://startupxyz.io"
}
]
Response Fields
| Field | Type | Description |
|---|---|---|
name | string | Company name |
website | string | Company website URL |
Pagination
Companies use offset-based pagination with page and limit parameters.
const page = 1;
const limit = 50;
const response = await fetch(
`https://api.jobven.com/v1/public/companies?page=${page}&limit=${limit}`,
{ headers: { 'X-API-Key': process.env.JOBVEN_API_KEY } }
);
const companies = await response.json();
// Fetch next page
const nextPage = page + 1;
For large datasets, prefer the Jobs endpoint which uses more efficient cursor-based pagination.