Advanced organization details

Parameters, response schema, and authenticated examples for /v1/ats-organizations-advanced.

Beta
GET
/v1/ats-organizations-advanced

Beta. Field names, response shape, and parameter behavior may change. Advanced organization profiles are refreshed monthly on the 1st at 02:00 UTC. Join to ATS jobs by org_linkedin_slug. Returns 100 results per page; use offset to paginate. Heavy nested fields require their include_* options. Basic org_crunchbase_total_investment is inside org_crunchbase_funding_and_investment.crunchbase_total_investment_usd in advanced profiles and requires include_crunchbase_funding_and_investment=true. See company workflow.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Authenticate requests with Authorization: Bearer YOUR_API_KEY. Find and manage your API key in the dashboard at https://dashboard.fantastic.jobs/dashboard. Store the key in an environment variable and never expose it in client-side code.

Query Parameters

limit?integer

Number of results to return. Default: 100, min: 1, max: 100.

Range1 <= value <= 100
Default100
offset?integer

Number of results to skip for pagination. e.g. limit=100&offset=200 returns the third page (results 201–300).

Range0 <= value
linkedin_name?array<string>

Filter to specific companies by LinkedIn organization name (org_linkedin_name). Exact, case-sensitive match - nvidia will not match NVIDIA. Input a comma-separated list to fetch several companies at once, e.g. linkedin_name=NVIDIA,OpenAI.

For a stable, case-insensitive identifier prefer linkedin_slug (filters on org_linkedin_slug, which is always returned by /active-ats / /modified-ats and listed in /ats-organizations).

linkedin_slug?array<string>

Filter to specific companies by LinkedIn slug (org_linkedin_slug) - the company-specific part of the LinkedIn URL (e.g. tesla-motors). Unique and stable per company, so this is the recommended way to fetch known organizations. Input a comma-separated list, e.g. linkedin_slug=nvidia,openai.

Discover slugs from /ats-organizations or from any ATS job (org_linkedin_slug is always returned).

include_crunchbase_funding_and_investment?boolean

Set to true to include org_crunchbase_funding_and_investment (Crunchbase funding rounds, investors, totals). Excluded by default.

include_linkedin_headcount_timeseries?boolean

Set to true to include org_linkedin_headcount_timeseries (weekly headcount plus role/skill/region breakdowns). Excluded by default.

include_linkedin_followers_timeseries?boolean

Set to true to include org_linkedin_followers_timeseries (weekly follower counts and growth rates). Excluded by default.

include_linkedin_estimated_revenue_timeseries?boolean

Set to true to include org_linkedin_estimated_revenue_timeseries (monthly estimated revenue ranges). Excluded by default.

include_news_articles?boolean

Set to true to include org_news_articles (recent news articles mentioning the company). Excluded by default.

include_glassdoor_reviews?boolean

Set to true to include org_glassdoor_reviews (recent employee reviews). Excluded by default.

Response Body

A list of organizations with advanced details

application/json

The response is an array. Each item is an object with these fields.

application/json response fields: response
FieldTypeDescription
id*
integer

Internal organization ID.

Format int64
org_linkedin_name*
string

Canonical company name from LinkedIn.

org_linkedin_url*
string

URL of the company's LinkedIn page.

Format uri
org_linkedin_slug*
string

Company-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Used to join organizations against jobs returned by /active-ats, /active-jb, and /modified-ats.

org_linkedin_description?
string

Description from the company's LinkedIn page.

org_linkedin_short_description?
string

Short tagline or description.

org_linkedin_headcount?
integer

Current number of employees according to LinkedIn.

org_linkedin_followers?
integer

Number of LinkedIn followers.

org_linkedin_size?
string

Employee count range according to the company (e.g., '1001-5000').

org_linkedin_industry?
string

Company's primary industry from LinkedIn's fixed list.

org_linkedin_headquarters?
string

Company's HQ location.

org_linkedin_type?
string

Company type (e.g., 'Privately Held', 'Public Company').

org_linkedin_founded_date?
string

Company's founded date.

org_linkedin_specialties?
array<string>

Company's specialties.

org_linkedin_locations?
array<string>

Full addresses of the company's locations.

org_linkedin_slogan?
|

Company's slogan.

org_linkedin_logo?
string

URL to the company's LinkedIn logo.

Format uri
org_linkedin_website?
string

Company's main website URL.

Format uri
org_linkedin_recruitment_agency_derived?
boolean

True if the company is a recruitment agency or job board (AI-identified).

org_linkedin_industries?
array<string>

All LinkedIn industry tags for the company.

org_linkedin_id?
integer

LinkedIn's internal company ID - the numeric identifier behind the company's LinkedIn page. Also returned inline on /active-jb, and on /active-ats / /modified-ats with include_basic_organization_details=true. Distinct from the job-side linkedin_id on /active-jb, which identifies a posting rather than a company.

Format int64
org_linkedin_estimated_revenue_lower_bound_usd?
integer

Lower bound of estimated annual revenue in USD.

org_linkedin_estimated_revenue_higher_bound_usd?
integer

Upper bound of estimated annual revenue in USD.

org_linkedin_largest_headcount_country?
string

Country with the most employees.

org_naics?

Primary NAICS industry classification.

org_sic?
array<>

SIC industry classifications. Each entry pairs a SIC code with its industry name and the year the classification applies to.

org_markets?
array<string>

Market segments the company operates in.

org_twitter_url?
string

Company's Twitter/X profile URL.

Format uri
org_logo_permalink?
string

Permanent URL to the company logo.

Format uri
org_crunchbase_profile_url?
string

URL to the company's Crunchbase profile.

Format uri
org_crunchbase_profile_uuid?
string

Crunchbase profile UUID.

org_crunchbase_fiscal_year_end?
|

Month the company's fiscal year ends.

org_crunchbase_acquisition_status?
|

Acquisition status (e.g., 'acquired', 'pending').

org_crunchbase_ipo_date?
|

IPO date if applicable.

org_crunchbase_categories?
array<string>

Crunchbase industry categories.

org_glassdoor_review_count?
integer

Total number of Glassdoor reviews.

org_glassdoor_salary_count?
integer

Total number of Glassdoor salary reports.

org_glassdoor_interview_count?
integer

Total number of Glassdoor interview reports.

org_glassdoor_benefit_count?
integer

Total number of Glassdoor benefit reports.

org_glassdoor_primary_industry_name?
string

Primary industry name on Glassdoor.

org_glassdoor_primary_industry_sector_name?
string

Primary industry sector on Glassdoor.

org_glassdoor_culture_and_values_rating?
number

Culture & values rating (0-5).

org_glassdoor_diversity_and_inclusion_rating?
number

Diversity & inclusion rating (0-5).

org_glassdoor_work_life_balance_rating?
number

Work-life balance rating (0-5).

org_glassdoor_senior_management_rating?
number

Senior management rating (0-5).

org_glassdoor_compensation_and_benefits_rating?
number

Compensation & benefits rating (0-5).

org_glassdoor_career_opportunities_rating?
number

Career opportunities rating (0-5).

org_glassdoor_recommend_to_friend_rating?
number

Recommend to friend rating (0-5).

org_glassdoor_business_outlook_rating?
number

Business outlook rating (0-5).

org_glassdoor_profile_url?
string

URL to the company's Glassdoor profile.

Format uri
org_crunchbase_funding_and_investment?

Crunchbase funding and investment data. Returned when include_crunchbase_funding_and_investment=true.

org_linkedin_headcount_timeseries?

LinkedIn headcount data with role, skill, and region breakdowns. Returned when include_linkedin_headcount_timeseries=true. Each *_metrics object is a distribution map: keys are bucket labels (all_roles, 0_to_10_percent, 11_to_30_percent, 31_to_50_percent, 51_to_70_percent, 71_to_100_percent); values are nullable strings listing the roles/skills/regions that fall into that share-of-headcount bucket.

org_linkedin_followers_timeseries?

LinkedIn follower data with growth rates. Returned when include_linkedin_followers_timeseries=true.

org_linkedin_estimated_revenue_timeseries?
array<>

Monthly estimated revenue over time. Returned when include_linkedin_estimated_revenue_timeseries=true.

org_news_articles?
array<>

Recent news articles mentioning the company. Returned when include_news_articles=true.

org_glassdoor_reviews?
array<>

Recent Glassdoor employee reviews. Returned when include_glassdoor_reviews=true.

Example Request
curl --fail-with-body --silent --show-error 'https://data.fantastic.jobs/v1/ats-organizations-advanced' \  --header "Authorization: Bearer ${FANTASTIC_JOBS_API_KEY:?Set FANTASTIC_JOBS_API_KEY}"
Example Response
[  {    "id": 28430662,    "org_linkedin_name": "OpenAI",    "org_linkedin_url": "https://www.linkedin.com/company/openai",    "org_linkedin_slug": "openai",    "org_linkedin_description": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity. AI is an extremely powerful tool that must be created with safety and human needs at its core. OpenAI is dedicated to putting that alignment of interests first — ahead of profit.\n\nTo achieve our mission, we must encompass and value the many different perspectives, voices, and experiences that form the full spectrum of humanity. Our investment in diversity, equity, and inclusion is ongoing, executed through a wide range of initiatives, and championed and supported by leadership.\n\nAt OpenAI, we believe artificial intelligence has the potential to help people solve immense global challenges, and we want the upside of AI to be widely shared. Join us in shaping the future of technology.",    "org_linkedin_short_description": "OpenAI is an AI research and deployment company focused on ensuring that general-purpose artificial intelligence safely benefits all of humanity through diverse, equitable practices.",    "org_linkedin_headcount": 11489,    "org_linkedin_followers": 12072338,    "org_linkedin_size": "1,001-5,000 employees",    "org_linkedin_industry": "Research Services",    "org_linkedin_headquarters": "San Francisco, CA",    "org_linkedin_type": "Partnership",    "org_linkedin_founded_date": "",    "org_linkedin_specialties": [      "artificial intelligence and machine learning"    ],    "org_linkedin_locations": [      "San Francisco, CA 94110, US"    ],    "org_linkedin_slogan": null,    "org_linkedin_logo": "https://media.licdn.com/dms/image/v2/D560BAQHpzXbqSyR74A/company-logo_200_200/B56ZT8EYB8HsAI-/0/1739395793272/openai_logo?e=2147483647&v=beta&t=KqQyuosYiiBMx7W0kz3PILrchXDcy1wsCN8EjnQdUJc",    "org_linkedin_website": "https://openai.com",    "org_linkedin_recruitment_agency_derived": false,    "org_linkedin_industries": [      "Research Services",      "Professional Services"    ],    "org_linkedin_id": 11130470,    "org_linkedin_estimated_revenue_lower_bound_usd": 50000000,    "org_linkedin_estimated_revenue_higher_bound_usd": 100000000,    "org_linkedin_largest_headcount_country": "USA",    "org_naics": {      "year": 2022,      "sector": "Professional, Scientific, and Technical Services",      "industry": "Research and Development in the Physical, Engineering, and Life Sciences (except Nanotechnology and Biotechnology)",      "naics_code": "541715",      "sub_sector": "Professional, Scientific, and Technical Services",      "industry_group": "Scientific Research and Development Services"    },    "org_sic": [      {        "year": 1987,        "industry": "Commercial Physical Research",        "sic_code": "8731"      },      {        "year": 1987,        "industry": "Noncommercial Research Organizations",        "sic_code": "8733"      }    ],    "org_markets": [      "PRIVATE"    ],    "org_twitter_url": "https://x.com/OpenAI",    "org_logo_permalink": "https://crustdata-media.s3.us-east-2.amazonaws.com/company/50d7e5f0c24238f6ee1866712d9fff81a2d3f76503fb7890c7a39e97c725f19f.jpg",    "org_crunchbase_profile_url": "https://crunchbase.com/organization/openai",    "org_crunchbase_profile_uuid": "cf2c678c-b81a-80c3-10d1-9c5e76448e51",    "org_crunchbase_fiscal_year_end": null,    "org_crunchbase_acquisition_status": null,    "org_crunchbase_ipo_date": null,    "org_crunchbase_categories": [      "AI Infrastructure",      "Agentic AI",      "Artificial Intelligence",      "Artificial Intelligence (AI)",      "Foundational AI",      "Generative AI",      "Information Services",      "Information Technology",      "Machine Learning",      "Natural Language Processing",      "SaaS",      "Software",      "Research and development",      "Management and consulting"    ],    "org_glassdoor_review_count": 182,    "org_glassdoor_salary_count": 331,    "org_glassdoor_interview_count": 281,    "org_glassdoor_benefit_count": 51,    "org_glassdoor_primary_industry_name": "Research and development",    "org_glassdoor_primary_industry_sector_name": "Management and consulting",    "org_glassdoor_culture_and_values_rating": 3.5,    "org_glassdoor_diversity_and_inclusion_rating": 3.5,    "org_glassdoor_work_life_balance_rating": 2.7,    "org_glassdoor_senior_management_rating": 3.6,    "org_glassdoor_compensation_and_benefits_rating": 4.3,    "org_glassdoor_career_opportunities_rating": 4,    "org_glassdoor_recommend_to_friend_rating": 0.7,    "org_glassdoor_business_outlook_rating": 0.76,    "org_glassdoor_profile_url": "https://www.glassdoor.com/Overview/Working-at-OpenAI-EI_IE2210885.11,17.htm"  }]