# Advanced Company Details

**Currently in BETA**

The [`ats-organizations-advanced`](/api/ats-organizations#advanced-organization-details) endpoint is a **per-organization deep profile**: A deeper LinkedIn profile, Industry taxonomies, Crunchbase funding, Glassdoor ratings & reviews, headcount/follower/revenue timeseries, and news articles. Use it to research, score, and enrich the companies in your feed.


Returns the full advanced profile for organizations matching your filters, 100 per page. Because the underlying snapshot only changes once a month (refreshed on the **1st of each month at 02:00 UTC**), 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.

:::note{title="Good to know"}

If you're **already calling `ats-organizations-advanced`**, you do **not** need to set `include_basic_organization_details=true` on the ATS endpoints - every basic field is already in the advanced response.

:::

## Filtering to specific companies

We've enabled the option to filter on specific companies: 

**`linkedin_slug` (recommended).** Filters on `org_linkedin_slug` - the company-specific part of the LinkedIn URL (e.g. `tesla-motors`). Unique and stable per company, so this is the most reliable way to fetch known organizations. Accepts a comma-separated list:

```
/ats-organizations-advanced?linkedin_slug=nvidia,openai
```

**`linkedin_name`.** Filters on `org_linkedin_name` with an **exact, case-sensitive match** (`nvidia` will not match `NVIDIA`). Also accepts a comma-separated list:

```
/ats-organizations-advanced?linkedin_name=NVIDIA,OpenAI
```

Both slugs and names can be discovered from the [Company List](/documentation/endpoints/company-list) or from any ATS job where `include_basic_organization_details=true` (`org_linkedin_slug` is always returned). Prefer `linkedin_slug` for the stable, case-insensitive key.

## Fields available only in advanced (not in basic)

On top of every basic field above, `ats-organizations-advanced` adds the following, all returned by default unless noted:

**Additional LinkedIn fields**

- `org_linkedin_url` - URL of the company's LinkedIn page
- `org_linkedin_id` - LinkedIn's internal company ID
- `org_linkedin_short_description` - Short tagline / one-liner
- `org_linkedin_logo` - Logo URL (LinkedIn-hosted, instead of the permalink included in basic)
- `org_linkedin_industries` - All LinkedIn industry tags (vs. the single primary industry in basic)
- `org_linkedin_estimated_revenue_lower_bound_usd`
- `org_linkedin_estimated_revenue_higher_bound_usd`
- `org_linkedin_largest_headcount_country`

**Industry / classification**

- `org_naics` - Primary NAICS code
- `org_sic` - SIC codes
- `org_markets` - Market segments

**Other links**

- `org_twitter_url`
- `org_crunchbase_profile_url`
- `org_crunchbase_profile_uuid`
- `org_glassdoor_profile_url`

**Crunchbase**

- `org_crunchbase_fiscal_year_end`
- `org_crunchbase_acquisition_status`
- `org_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_count`
- `org_glassdoor_primary_industry_name`, `org_glassdoor_primary_industry_sector_name`
- `org_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_investment` is exposed inline in the basic response (as a single integer) but in advanced lives only inside `org_crunchbase_funding_and_investment.crunchbase_total_investment_usd` - so if you rely on that one number alone, you also need to opt into `include_crunchbase_funding_and_investment=true`.



## Basic company details

- On [`active-jb`](/api/new-jobs#job-board-jobs) (LinkedIn, Wellfound, Y Combinator) they are **always included** - the LinkedIn org is read directly from the job board, so the match is exact and always-on.
- On [`active-ats`](/api/new-jobs#ats-jobs) and [`modified-ats`](/api/modified-jobs#modified-ats-jobs) they are **opt-in** - set `include_basic_organization_details=true` and the fields appear inline on every job.

They cover the most common LinkedIn company fields: `org_linkedin_name`, `org_linkedin_website`, `org_linkedin_industry`, `org_linkedin_headcount`, `org_linkedin_size`, `org_linkedin_followers`, `org_linkedin_headquarters`, `org_linkedin_locations`, `org_linkedin_type`, `org_linkedin_founded_date`, `org_linkedin_slogan`, `org_linkedin_description`, `org_linkedin_specialties`, `org_linkedin_recruitment_agency_derived`, `org_crunchbase_categories`, `org_crunchbase_total_investment`, and `org_logo_permalink`.

Every one of these fields is **also** present in the advanced response, so if you're already calling `ats-organizations-advanced` you don't need `include_basic_organization_details=true` as well.