Organizations
Two endpoints are available for company data:
| Endpoint | Purpose | Refresh cadence |
|---|---|---|
organizations | Overview of every organization currently tracked across ATS sources, with basic LinkedIn company details. Useful for browsing the catalog and discovering valid organization, organization_domain, and organization_slug values to filter jobs by. | Daily snapshot, refreshed at 02:00 UTC |
organizations-advanced | Per-organization deep data: LinkedIn profile, Crunchbase funding, Glassdoor ratings & reviews, headcount/follower/revenue timeseries, and news articles. Paginated, 100 results per page. | Monthly snapshot, refreshed on the 1st of each month at 02:00 UTC |
When you need these endpoints
Both organization endpoints are primarily intended for ATS workflows (active-ats and modified-ats).
- Job board consumers (
active-jb) already receive LinkedIn organization fields inline on every job (the LinkedIn org is read directly from the job board, so the match is exact and always-on). You typically don't need to callorganizationsat all, and only needorganizations-advancedif you specifically want the deeper Crunchbase / Glassdoor / timeseries data. - ATS consumers can either opt into the inline basic fields with
include_basic_organization_details=true, or fetch them separately fromorganizations/organizations-advancedand join onorg_linkedin_slug. If you're already callingorganizations-advanced, you do not need to setinclude_basic_organization_details=trueon the ATS endpoints - every basic field is already in the advanced response.
organizations
The response is a single JSON array (no pagination, no filters) of every organization currently in the ATS catalog. It is intended as a one-shot overview / lookup table - cache the response on your side and refer back to it when you need to confirm an organization's slug, domain, or LinkedIn details. There is no benefit to polling it on a tight schedule.
The payload is approximately 50MB and may not render in the API playground; use curl or your HTTP client of choice to download it directly.
organizations-advanced
Returns the full advanced profile for organizations matching your filters, 100 per page. Because the underlying snapshot only changes once a month, you don't need to re-fetch the same organization in between releases - cache results by org_linkedin_slug and only refresh after the 1st of the month.
Fields available only in advanced (not in basic)
The basic organization details (include_basic_organization_details=true on ATS, always-on for JB) cover the most common LinkedIn fields like name, industry, headcount, size, followers, HQ, locations, type, founded date, slogan, description, specialties, and the recruitment-agency flag.
organizations-advanced adds the following on top, all returned by default unless noted:
Additional LinkedIn fields
org_linkedin_url- URL of the company's LinkedIn pageorg_linkedin_id- LinkedIn's internal company IDorg_linkedin_short_description- Short tagline / one-linerorg_linkedin_logo- Logo URL (LinkedIn-hosted)org_linkedin_industries- All LinkedIn industry tags (vs. the single primary industry in basic)org_linkedin_estimated_revenue_lower_bound_usdorg_linkedin_estimated_revenue_higher_bound_usdorg_linkedin_largest_headcount_country
Industry / classification
org_naics- Primary NAICS codeorg_sic- SIC codesorg_markets- Market segments
Other links
org_twitter_urlorg_crunchbase_profile_urlorg_crunchbase_profile_uuidorg_glassdoor_profile_url
Crunchbase
org_crunchbase_fiscal_year_endorg_crunchbase_acquisition_statusorg_crunchbase_ipo_date
Glassdoor scalars (counts and 0-5 ratings)
org_glassdoor_review_count,org_glassdoor_salary_count,org_glassdoor_interview_count,org_glassdoor_benefit_countorg_glassdoor_primary_industry_name,org_glassdoor_primary_industry_sector_nameorg_glassdoor_culture_and_values_rating,org_glassdoor_diversity_and_inclusion_rating,org_glassdoor_work_life_balance_rating,org_glassdoor_senior_management_rating,org_glassdoor_compensation_and_benefits_rating,org_glassdoor_career_opportunities_rating,org_glassdoor_recommend_to_friend_rating,org_glassdoor_business_outlook_rating
Heavy nested fields (opt-in via the matching include_* flag)
| Field | Flag |
|---|---|
org_crunchbase_funding_and_investment (rounds, investors, totals) | include_crunchbase_funding_and_investment=true |
org_linkedin_headcount_timeseries (weekly headcount + role/skill/region breakdowns) | include_linkedin_headcount_timeseries=true |
org_linkedin_followers_timeseries (weekly follower counts + growth rates) | include_linkedin_followers_timeseries=true |
org_linkedin_estimated_revenue_timeseries (monthly estimated revenue ranges) | include_linkedin_estimated_revenue_timeseries=true |
org_news_articles (recent news mentioning the company) | include_news_articles=true |
org_glassdoor_reviews (recent employee reviews) | include_glassdoor_reviews=true |
Each include_* flag adds significant payload size; only enable the ones you actually consume.
Note:
org_crunchbase_total_investmentis exposed inline in the basic response (as a single integer) but in advanced lives only insideorg_crunchbase_funding_and_investment.crunchbase_total_investment_usd- so if you rely on that one number alone, you also need to opt intoinclude_crunchbase_funding_and_investment=true.