Resolve a domain to a company profile

Build or fetch a company profile from a website domain, in the same CompanyDto shape as GET /api/companies/{id}. Evidence comes from the company’s own site (live and from Common Crawl), our company corpus and public datasets; every published value is backed by stored evidence, and fields the evidence does not support come back null rather than guessed.

A cached profile answers 200 immediately. A first lookup starts a profiling run and waits up to wait seconds (default 25, max 60); if the run is still going you get 202 with a status_url to poll. tier=deep runs the slower, more thorough pipeline and always answers 202 unless a deep profile is already cached.

The returned id is not a Jobo company id — it is a stable identifier for the domain’s profile and will not resolve at GET /api/companies/{id}. listing_url is filled only when an ATS listing is known for the domain.

Pricing: a flat 3 credits per delivered profile, charged up-front and refunded automatically on 202 and on any error. Profiles are cached for 180 days and refreshed in the background as they age; refresh=true forces a fresh run. The X-Jobo-Profile-Cache header reports hit, stale (served while refreshing) or miss.

GET /api/companies/by-domain

cURL

cURL

# First call: the profile is built while you wait (up to `wait` seconds), or you get a 202 to poll.
curl -G "https://connect.jobo.world/api/companies/by-domain" \
  -H "X-Api-Key: $JOBO_API_KEY" \
  --data-urlencode "domain=stripe.com" \
  --data-urlencode "wait=25"

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "legal_name": "<string>",
  "summary": "<string>",
  "description": "<string>",
  "website": "<string>",
  "listing_url": "<string>",
  "logo_url": "<string>",
  "linkedin_url": "<string>",
  "linkedin_company_id": "<string>",
  "twitter_url": "<string>",
  "facebook_url": "<string>",
  "instagram_url": "<string>",
  "angellist_url": "<string>",
  "youtube_url": "<string>",
  "github_url": "<string>",
  "g2_url": "<string>",
  "crunchbase_url": "<string>",
  "headquarters_location": "<string>",
  "headquarters_region": "<string>",
  "headquarters_regions": [
    "<string>"
  ],
  "country_code": "<string>",
  "continent": "<string>",
  "phone_number": "<string>",
  "email_address": "<string>",
  "founding_year": "<string>",
  "company_size": "<string>",
  "revenue": "<string>",
  "is_agency": true,
  "industries": [
    "<string>"
  ],
  "primary_industry": "<string>",
  "categories": [
    "<string>"
  ],
  "naics_codes": [
    "<string>"
  ],
  "operating_status": "<string>",
  "ipo_status": "<string>",
  "company_type": "<string>",
  "stock_symbol": "<string>",
  "stock_exchange": "<string>",
  "is_acquired": true,
  "acquired_by_company": "<string>",
  "parent_company_url": "<string>",
  "funding_stage": "<string>",
  "total_funding": "<string>",
  "funds_total_formatted": "<string>",
  "investors": [
    "<string>"
  ],
  "funding_rounds": [
    {
      "investment_type": "<string>",
      "announced_on": "<string>",
      "raised_amount": "<string>",
      "post_money_valuation": "<string>",
      "investor_count": 123,
      "lead_investor": "<string>"
    }
  ],
  "founders": [
    "<string>"
  ],
  "leadership": [
    {
      "name": "<string>",
      "title": "<string>",
      "linkedin_url": "<string>",
      "avatar_url": "<string>"
    }
  ],
  "leadership_hires": [
    {
      "date": "<string>"
    }
  ],
  "layoffs": [
    {
      "date": "<string>"
    }
  ],
  "ratings": [
    {
      "source": "<string>",
      "rating": "<string>",
      "url": "<string>",
      "review_count": 123
    }
  ],
  "press_references": [
    {
      "url": "<string>",
      "posted_on": "<string>",
      "title": "<string>",
      "publisher": "<string>"
    }
  ],
  "h1b_annual_job_counts": [
    {
      "year": "<string>",
      "count": 123
    }
  ],
  "h1b_title_distribution": [
    {
      "title": "<string>",
      "count": 123
    }
  ],
  "technology_list": [
    "<string>"
  ],
  "tech_stack": [
    {
      "name": "<string>",
      "categories": [
        "<string>"
      ]
    }
  ],
  "products": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "software_used": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "research_focus_areas": [
    "<string>"
  ],
  "acquisitions": [
    {
      "acquiree_name": "<string>",
      "title": "<string>"
    }
  ],
  "exits": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "subsidiary_list": [
    "<string>"
  ],
  "sub_organizations": [
    {
      "name": "<string>",
      "ownership_type": "<string>",
      "title": "<string>"
    }
  ],
  "featured_lists": [
    {
      "title": "<string>",
      "org_num": 123,
      "funding_total_formatted": "<string>",
      "funding_total_usd": 123
    }
  ],
  "event_appearances": [
    {
      "appearance_type": "<string>",
      "event": "<string>",
      "event_starts_on": "<string>",
      "image": "<string>"
    }
  ],
  "investor_types": [
    "<string>"
  ],
  "page_rank": 123,
  "ats_provider": "<string>",
  "careers_url": "<string>",
  "social_links": {},
  "technologies": [
    "<string>"
  ],
  "technology_mentions": [
    "<string>"
  ]
}

Authorizations

X-Api-Key · string · header · required

API key provided by Jobo

Query Parameters

domain · string · required

Website domain or URL, e.g. stripe.com.

wait · integer · default: 25

Seconds to wait for a cold run before answering 202.

Required range: 0 <= x <= 60

tier · enum<string> · default: standard

Pipeline depth. deep is asynchronous and always answers 202 unless cached.

Available options: standard, deep

refresh · boolean · default: false

Ignore the cached profile and stored evidence; re-acquire everything.

Response

200

application/json

The company profile

Fully enriched company profile.

id · string<uuid> · required

name · string · required

legal_name · string | null · required

Registered legal entity name when distinct from the trade name.

summary · string | null · required

Short company blurb. AI-generated when available, otherwise the SEO meta-description / first paragraph from the enrichment source.

description · string | null · required

website · string | null · required

listing_url · string | null · required

Canonical careers / job-listing page URL on the company's ATS (e.g. its Greenhouse / Lever / Workday board), when available.

logo_url · string | null · required

linkedin_url · string | null · required

linkedin_company_id · string | null · required

twitter_url · string | null · required

facebook_url · string | null · required

instagram_url · string | null · required

angellist_url · string | null · required

youtube_url · string | null · required

github_url · string | null · required

g2_url · string | null · required

crunchbase_url · string | null · required

headquarters_location · string | null · required

headquarters_region · string | null · required

Region/state when known.

headquarters_regions · string[] · required

Additional region tags when more than one applies.

country_code · string | null · required

ISO 3166-1 alpha-2 country code.

continent · string | null · required

phone_number · string | null · required

email_address · string | null · required

founding_year · string | null · required

company_size · string | null · required

Headcount band (e.g. "1-10", "51-200").

revenue · string | null · required

Annual revenue band (e.g. "under-1m", "100m-200m", "over-1b").

is_agency · boolean · required

industries · string[] · required

Vertical industry labels (e.g. "HR & Staffing").

primary_industry · string | null · required

Single high-level industry label (e.g. "Finance").

categories · string[] · required

Business-model bucket tags (b2b / b2c / saas / service-provider).

naics_codes · string[] · required

operating_status · string | null · required

"active" | "closed".

ipo_status · string | null · required

"private" | "ipo" | "delisted".

company_type · string | null · required

"for_profit" | "non_profit".

stock_symbol · string | null · required

stock_exchange · string | null · required

is_acquired · boolean · required

acquired_by_company · string | null · required

parent_company_url · string | null · required

URL of the parent organization when this company is a subsidiary.

funding_stage · string | null · required

total_funding · string | null · required

funds_total_formatted · string | null · required

Total funds raised when the company itself is a VC firm.

investors · string[] · required

funding_rounds · object[] · required

Show child attributes

founders · string[] · required

leadership · object[] · required

Show child attributes

leadership_hires · object[] · required

Show child attributes

layoffs · object[] · required

Show child attributes

ratings · object[] · required

Show child attributes

press_references · object[] · required

Show child attributes

h1b_annual_job_counts · object[] · required

Show child attributes

h1b_title_distribution · object[] · required

Show child attributes

technology_list · string[] · required

Flat list of technologies the company is reported to use (catalogue names plus mentions).

tech_stack · object[] · required

Structured per-technology records.

Show child attributes

products · object[] · required

Show child attributes

software_used · object[] · required

Show child attributes

research_focus_areas · string[] · required

acquisitions · object[] · required

Show child attributes

exits · object[] · required

Show child attributes

subsidiary_list · string[] · required

Flat list of subsidiary company names.

sub_organizations · object[] · required

Show child attributes

featured_lists · object[] · required

Show child attributes

event_appearances · object[] · required

Show child attributes

investor_types · string[] · required

Investor classification (only populated when the company is itself an investor).

page_rank · number<double> | null · required

Domain authority score (useful for ranking).

ats_provider · string | null

Applicant tracking system the company hires through (catalogue id, e.g. greenhouse), when detected.

careers_url · string | null

The company's own careers page, when found.

social_links · object

Every social / review profile found for the company, keyed by platform (linkedin, twitter, facebook, instagram, youtube, github, g2, crunchbase, angellist, tiktok, glassdoor, xing, threads, bluesky, pinterest, vimeo, medium, kununu, trustpilot, indeed, mastodon). The flat *_url fields carry the same values for the platforms that have one; this map is the complete set.

Show child attributes

technologies · string[]

Technologies detected on the company's website as stable catalogue slugs (google-tag-manager, shopify, hubspot, …). Deterministic and normalised — this is the field to filter on.

technology_mentions · string[]

Technologies named in prose that did not map to a catalogue slug. Display only.