Enrich companies

Every job from search or the feed embeds a company summary: id, name, website and a few other fields. The companies endpoints turn that id, or a website domain, into a full profile.

Endpoint	Input	API key	Cost	Rate-limit group
`GET /api/companies/{id}`	Jobo company ID	Not needed	Free	Not rate limited (CDN-cached)
`GET /api/companies/{id}/jobs`	Jobo company ID	Required	Per delivered job	`JobSearch`, shared with search
`GET /api/companies/by-domain` (beta)	Website domain	Required	$0.003 per delivered profile	`DataSets`

Prices and plans are on Billing, limits per group on Rate limits, and error envelopes on Errors.

Find a company ID

Company IDs come from jobs, not from a lookup:

company.id on every job object.
company.details_url on the same summary is the profile endpoint’s URL, ready to link to without building it yourself.

Have only a website? Enrich the company from its domain instead.

Get a company profile

GET /api/companies/{id} returns the fully enriched CompanyDto, or 404 for an unknown, disabled or incomplete company.

curl "https://connect.jobo.world/api/companies/b5e6f7a8-1234-5678-9abc-def012345678"

import os
from jobo_enterprise import JoboClient

company_id = "b5e6f7a8-1234-5678-9abc-def012345678"  # from job.company.id

with JoboClient(api_key=os.environ["JOBO_API_KEY"]) as client:
    company = client.companies.get(company_id)
    print(company.name, company.funding_stage, company.company_size)

The profile needs no API key, so company.details_url is safe to put in front of end users. It resolves from a browser with no authentication on your side.

What enrichment covers

Group	Main fields
Identity and social	`name`, `legal_name`, `description`, `website`, `logo_url`, `linkedin_url`, `crunchbase_url`, `github_url` and other profile URLs
Corporate facts	`headquarters_location`, `company_size`, `revenue`, `operating_status`, `ipo_status`, `stock_symbol`
Funding	`funding_stage`, `total_funding`, `investors`, `funding_rounds` (round by round)
Company events	`leadership_hires`, `layoffs`, each dated
Reputation	`ratings`: employer ratings and review counts, where available
Products and technology	`technologies`, `tech_stack`, `products`, `software_used`
Relationships	`acquisitions`, `exits`, `sub_organizations`
H-1B data (US companies)	`h1b_annual_job_counts` per year, `h1b_title_distribution` by job title

The Company object reference lists every field. Unknown data comes back as [] or null, so an empty list means “unknown,” not “none.”

List open jobs

GET /api/companies/{id}/jobs returns the jobs a company currently has posted, one page at a time. page_size defaults to 25 and maxes out at 100; see Pagination.

curl "https://connect.jobo.world/api/companies/b5e6f7a8-1234-5678-9abc-def012345678/jobs?page=1&page_size=25" \
  -H "X-Api-Key: $JOBO_API_KEY"

import os
from jobo_enterprise import JoboClient

company_id = "b5e6f7a8-1234-5678-9abc-def012345678"  # from job.company.id

with JoboClient(api_key=os.environ["JOBO_API_KEY"]) as client:
    result = client.companies.get_jobs(company_id, page=1, page_size=25)
    for job in result.jobs:
        print(job.title, job.listing_url)

It’s billed like search: per delivered job, from your included jobs first. The Unlimited plan doesn’t cover it, and an empty page costs nothing. An unknown company ID returns 200 with an empty jobs array, not 404. Check the array length, not the status code.

Enrich a company from its domain (beta)

Beta, available on activation. Email support@jobo.world to switch it on for your account. Until then, calls return 403 with code: company_enrichment_not_enabled and cost nothing.

Company Enrichment, GET /api/companies/by-domain, turns a website domain into a profile in the same CompanyDto shape.

curl -G "https://connect.jobo.world/api/companies/by-domain" \
  -H "X-Api-Key: $JOBO_API_KEY" \
  --data-urlencode "domain=stripe.com"

The returned id identifies the domain’s profile, not a Jobo company, so it doesn’t resolve at GET /api/companies/{id}.

Response	Meaning	What to do
`200`	The profile, cached or freshly built. `X-Jobo-Profile-Cache` is `hit`, `stale` or `miss`.	Use it.
`202`	A new domain is still being profiled after `wait` seconds (default 25, max 60).	Poll `status_url` after `retry_after_seconds`.
`400`	Not a usable public website domain.	Fix the input.
`404`	The domain is dead, parked or refused every fetch.	Don’t retry right away: the result is cached briefly.
`503`	Profiling is temporarily unavailable. Nothing is charged.	Retry after `Retry-After`.

Poll a pending profile

A 202 carries a status_url, also sent as the Location header along with Retry-After. Cold runs usually take one to five minutes.

{
  "status": "pending",
  "stage": "acquiring",
  "sources_done": 2,
  "sources_total": 6,
  "retry_after_seconds": 5,
  "status_url": "/api/companies/by-domain/status?domain=stripe.com"
}

Poll status_url rather than calling by-domain again. Repeat calls count against the DataSets rate limit; the poll counts toward Default. The poll returns 202 while the run goes through queued, resolving, acquiring and extracting, then 200 with the profile. It returns 404 when the domain yielded no profile or no run is in progress. Profiles are cached for 180 days and refreshed in the background as they age. refresh=true forces a fresh run; fresh runs are limited per domain per day, and past the limit the request returns 503 with Retry-After.

What a profile costs

A delivered profile costs $0.003 (3 credits), cached ones included. Included jobs don’t apply, and the Unlimited plan doesn’t cover it. The charge is taken up front and refunded automatically on any error.

Response	Charge
`200`	3 credits.
`202` that started a new profiling run	Keeps its 3 credits. The poll or a repeat call then delivers the profile free, or refunds the 3 credits if the run finds nothing.
`202` that joined a run already in progress	Refunded. The poll charges 3 credits when it delivers the profile.
Poll while the run is pending	Free.

Get started

How-to guides

Build with AI assistants

Connectors

Resources

Find a company ID

Get a company profile

What enrichment covers

List open jobs

Enrich a company from its domain (beta)

Poll a pending profile

What a profile costs

​Find a company ID

​Get a company profile

​What enrichment covers

​List open jobs

​Enrich a company from its domain (beta)

​Poll a pending profile

​What a profile costs

Find a company ID

Get a company profile

What enrichment covers

List open jobs

Enrich a company from its domain (beta)

Poll a pending profile

What a profile costs