Poll a domain profile run

Poll a run started by GET /api/companies/by-domain. Answers 202 with progress while the run is in flight, 200 with the profile once it is ready (charged 3 credits, like any delivered profile), and 404 when the domain yielded no profile or no run is in progress. Free while pending; never starts a run.

GET /api/companies/by-domain/status

cURL

cURL

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

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

The domain passed to GET /api/companies/by-domain.

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.