# Built In API: US tech jobs and companies from builtin.com and its city sites (NYC, SF, Chicago, Boston, Seattle, LA, Austin, Colorado): job search with every filter, full job posts with salary and skills, company profiles with employees, offices, tech stack, benefits and insights, company directory, salaries by title and city, articles and Best Places to Work lists, no login

> Search Built In jobs with every filter the site offers: keywords, location (city/state/country, radius, all locations, or a city site such as Built In NYC), remote/hybrid/on-site, category and subcategory, experience level, industry, company size, posted within 1/3/7/30 days, early applicant and skills. 25 jobs per page with keywords; the site's pager tops out at 10,000 rows.
> ReefAPI engine `builtin` · 16 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/builtin/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/builtin/v1/search — 1 credit
Search Built In jobs with every filter the site offers: keywords, location (city/state/country, radius, all locations, or a city site such as Built In NYC), remote/hybrid/on-site, category and subcategory, experience level, industry, company size, posted within 1/3/7/30 days, early applicant and skills. 25 jobs per page with keywords; the site's pager tops out at 10,000 rows.

**Parameters:**
- `keywords` (string, optional) — Job title, skill or company words, as typed in the site's search box. Optional: leave empty to browse with filters only.
- `location` (string, optional) — Where: free text the site's own location box accepts ('Chicago', 'Austin, TX', 'Denver, CO', 'Toronto'); resolved through Built In's location service. Ignored when city/state are given.
- `city` (string, optional) — City name exactly as Built In stores it (with state).
- `state` (string, optional) — US state name (full), or a region name abroad.
- `country` (string, optional, default "USA") — ISO-3 country code (USA, CAN, GBR, DEU, IND...) or ISO-2 (US, CA, UK). Default USA. Built In lists jobs in many countries; without a location the site would otherwise use the caller's IP country.
- `all_locations` (boolean, optional, default false) — true = jobs in every country (the site's 'All locations').
- `city_site` (enum, optional) — One of Built In's city sites; same jobs as that site's board (each one is the national board with its location preset). [one of: nyc, sf, chicago, boston, seattle, la, austin, colorado]
- `radius_miles` (enum, optional) — Search radius around a city (needs location/city). [one of: 5, 10, 25, 50, 100]
- `work_arrangement` (array, optional) — remote, hybrid, office (on-site). Several = OR. [one of: remote, hybrid, office]
- `category` (string, optional) — Job category: alias, id or name (ai-machine-learning, consultant, customer-success-experience, cyber-security, data-analytics, designer, engineering, finance, hr-recruiting, legal, marketing, operations-support, product-management, program-project-management, sales, supply-chain-procurement). One category, like the site. [one of: ai-machine-learning, consultant, customer-success-experience, cyber-security, data-analytics, designer, engineering, finance, hr-recruiting, legal, marketing, operations-support, product-management, program-project-management, sales, supply-chain-procurement]
- `subcategory` (array, optional) — Subcategory alias/id/name inside the category (filters action lists all 108).
- `experience` (array, optional) — Experience levels; several = OR. [one of: internship, entry-level, junior, mid-level, senior, expert-leader, not-specified]
- `industry` (array, optional) — Industry alias/id/name (103 values; filters action). Several = OR.
- `company_size` (array, optional) — Company size buckets; several = OR. [one of: 1-10, 11-50, 51-200, 201-500, 501-1000, 1000]
- `posted_within_days` (enum, optional) — Only jobs posted (or reposted) in the last N days. [one of: 1, 3, 7, 30]
- `early_applicant` (boolean, optional, default false) — true = the site's 'Be an early applicant' filter (jobs with few applicants so far).
- `skills` (array, optional) — Skill names as the site lists them (data.skill_counts of a search). Several = jobs with any of them.
- `page` (integer, optional, default 1) — Result page (25 jobs per page with keywords; ~10-18 without). The site stops at page 400 (keywords) / 1000 (no keywords).

**Returns:** jobs[]{job_id, title, url, slug, company{name, alias, url, logo_url}, location, locations[], location_count, work_arrangement, salary{label, min_from_label, max_from_label, period}, experience_level, industries[], summary, top_skills[], posted, reposted, published_at, featured} + skill_counts[] + filters_applied + meta.pagination{page, total_pages, has_more, capped}

**Example request body:**
```json
{
  "keywords": "data engineer"
}
```

### POST https://api.reefapi.com/builtin/v1/detail — 1 credit
Full Built In job post: title, company (HQ, employees, founded, what we do), every location with street address and coordinates, work arrangement, salary range, experience level, employment type, industries, Built In's summary, full description (text + HTML), skills required, benefits, posted / valid-through dates, easy-apply flag and similar jobs.

**Parameters:**
- `url` (string, required) — Job URL from search (builtin.com/job/<slug>/<id>), or '<slug>/<id>'. A bare numeric id is not enough: Built In addresses job pages by slug + id (search returns both).

**Returns:** job{job_id, slug, url, title, company{...}, location, hiring_remotely, locations[], job_locations[]{street, city, region, postal_code, country, latitude, longitude}, work_arrangement, salary{label, min, max, currency, unit, min_from_label, max_from_label, period_from_label}, experience_level, employment_type, industries[], tagline, summary, description, description_html, skills_required[], benefits[], posted, date_posted, valid_through, direct_apply, is_easy_apply, apply_url, compensation_highlights[], team_quotes[]{name, role, quote}, similar_jobs[]}

**Example request body:**
```json
{
  "url": "https://builtin.com/job/managed-services-data-engineer-senior-associate/11825993"
}
```

### POST https://api.reefapi.com/builtin/v1/company — 1 credit
Built In company profile: website, HQ and address, total offices and every office (with address), total and product+tech employees, year founded, industries, description, open jobs (total and by category), recent jobs, workspace policy, teams, award badges, benefits overview, tech stack, articles mentioning it and the company-insight topics.

**Parameters:**
- `company` (string, required) — Company alias from a Built In URL (builtin.com/company/<alias>) or the full URL. company-search turns a name into an alias.

**Returns:** company{company_id, alias, name, url, website, logo_url, description, industries[], hq, address, total_offices, office_cities[], total_employees, product_tech_employees, year_founded, open_jobs, open_jobs_by_category[], recent_jobs[], workspace, offices[], teams[], award_badges[], perks_overview[], tech_stack[]{name,type,group}, articles[], insight_topics[]}

**Example request body:**
```json
{
  "company": "pwc"
}
```

### POST https://api.reefapi.com/builtin/v1/company-jobs — 2 credits
All open jobs of one company (every location), with the same filters and pagination as search.

**Parameters:**
- `company` (string, required) — Company alias, URL, or numeric company_id (company / company-search / companies return it; a numeric id saves one request).
- `keywords` (string, optional) — Job title, skill or company words, as typed in the site's search box. Optional: leave empty to browse with filters only.
- `work_arrangement` (array, optional) — remote, hybrid, office (on-site). Several = OR. [one of: remote, hybrid, office]
- `category` (string, optional) — Job category: alias, id or name (ai-machine-learning, consultant, customer-success-experience, cyber-security, data-analytics, designer, engineering, finance, hr-recruiting, legal, marketing, operations-support, product-management, program-project-management, sales, supply-chain-procurement). One category, like the site. [one of: ai-machine-learning, consultant, customer-success-experience, cyber-security, data-analytics, designer, engineering, finance, hr-recruiting, legal, marketing, operations-support, product-management, program-project-management, sales, supply-chain-procurement]
- `subcategory` (array, optional) — Subcategory alias/id/name inside the category (filters action lists all 108).
- `experience` (array, optional) — Experience levels; several = OR. [one of: internship, entry-level, junior, mid-level, senior, expert-leader, not-specified]
- `posted_within_days` (enum, optional) — Only jobs posted (or reposted) in the last N days. [one of: 1, 3, 7, 30]
- `page` (integer, optional, default 1) — Result page (25 jobs per page with keywords; ~10-18 without). The site stops at page 400 (keywords) / 1000 (no keywords).

**Returns:** jobs[]{job_id, title, url, slug, company{name, alias, url, logo_url}, location, locations[], location_count, work_arrangement, salary{label, min_from_label, max_from_label, period}, experience_level, industries[], summary, top_skills[], posted, reposted, published_at, featured} + skill_counts[] + filters_applied + meta.pagination{page, total_pages, has_more, capped}

**Example request body:**
```json
{
  "company": "pwc"
}
```

### POST https://api.reefapi.com/builtin/v1/company-benefits — 1 credit
Every benefit and perk a company lists on Built In, grouped as on its Benefits tab.

**Parameters:**
- `company` (string, required) — Company alias from a Built In URL (builtin.com/company/<alias>) or the full URL. company-search turns a name into an alias.

**Returns:** benefits[]{group, subgroups[]{name, benefits[]}} + benefits_count

**Example request body:**
```json
{
  "company": "pwc"
}
```

### POST https://api.reefapi.com/builtin/v1/company-insights — 1 credit
Built In's company-insight Q&A for one topic (culture, career growth, compensation, work-life balance, leadership, innovation, stability...): every question and full answer.

**Parameters:**
- `company` (string, required) — Company alias from a Built In URL (builtin.com/company/<alias>) or the full URL. company-search turns a name into an alias.
- `topic` (enum, optional, default "workplace-perception") — Insight topic (company.insight_topics lists the ones a company has). [one of: workplace-perception, culture-values, inclusion-diversity, career-growth-development, compensation-benefits, work-life-balance-wellbeing, leadership-management, innovation-technology-agility, mission-purpose-impact, stability-growth]

**Returns:** insights{title, updated, questions[]{question, answer, answer_html, date_published, date_modified}}

**Example request body:**
```json
{
  "company": "pwc"
}
```

### POST https://api.reefapi.com/builtin/v1/company-articles — 1 credit
Built In articles that feature a company (author, date, excerpt, tags).

**Parameters:**
- `company` (string, required) — Company alias from a Built In URL (builtin.com/company/<alias>) or the full URL. company-search turns a name into an alias.

**Returns:** articles[]{article_id, title, url, author, date_label, date_type, date, excerpt, tags[], image_url}

**Example request body:**
```json
{
  "company": "pwc"
}
```

### POST https://api.reefapi.com/builtin/v1/company-search — 1 credit
Find companies by name (Built In's own company lookup): id, alias, logo, industries. Up to 10 matches, the site's limit.

**Parameters:**
- `query` (string, required) — Company name or part of it.
- `limit` (integer, optional, default 10) — Matches to return (the site caps this at 10).

**Returns:** companies[]{company_id, name, alias, url, logo_url, industries[]}

**Example request body:**
```json
{
  "query": "stripe"
}
```

### POST https://api.reefapi.com/builtin/v1/companies — 1 credit
Built In company directory with its filters: location, industry, company size, office type (hybrid / on-site / fully remote), hiring remotely, has open jobs, perks, tech stack and DEI practices. 20 companies per page.

**Parameters:**
- `location` (string, optional) — Where: free text the site's own location box accepts ('Chicago', 'Austin, TX', 'Denver, CO', 'Toronto'); resolved through Built In's location service. Ignored when city/state are given.
- `city` (string, optional) — City name exactly as Built In stores it (with state).
- `state` (string, optional) — US state name (full), or a region name abroad.
- `country` (string, optional, default "USA") — ISO-3 country code (USA, CAN, GBR, DEU, IND...) or ISO-2 (US, CA, UK). Default USA. Built In lists jobs in many countries; without a location the site would otherwise use the caller's IP country.
- `region` (string, optional) — Built In metro region alias (company directory regions, e.g. new-york-city, austin, chicago; filters action).
- `industry` (array, optional) — Industry alias/id/name (103 values; filters action). Several = OR.
- `company_size` (array, optional) — Company size buckets; several = OR. [one of: 1-10, 11-50, 51-200, 201-500, 501-1000, 1000]
- `office_type` (array, optional) — Office policy; several = OR. [one of: hybrid, onsite, remote]
- `hiring_remote` (boolean, optional, default false) — Only companies with open remote jobs.
- `has_open_jobs` (boolean, optional, default false) — Only companies with open jobs (ignored when hiring_remote=true).
- `perks` (array, optional) — Perk url names (90; filters action).
- `tech_stack` (array, optional) — Technology url names (213; filters action), e.g. python, react.
- `dei` (array, optional) — DEI practice url names (9; filters action).
- `page` (integer, optional, default 1) — Result page (20 per page; the pager stops at 500).

**Returns:** companies[]{company_id, name, alias, url, logo_url, photo_url, industries[], location, offices, employees, benefits_count, hiring_now, has_teams_page, tagline, description_excerpt, featured} + total_label + meta.pagination

**Example request body:**
```json
{
  "industry": "fintech"
}
```

### POST https://api.reefapi.com/builtin/v1/salaries — 1 credit
Built In salary data for a job title, nationally or in one city: average base, additional cash, total compensation, median, min/max and percentiles, distribution, averages by experience, gender and company size, skills, recent anonymous salary reports, other cities and related titles.

**Parameters:**
- `job_title` (string, required) — Job title as Built In names it ('Data Engineer', 'product-manager').
- `location` (string, optional) — City slug or name with state ('New York City, NY', 'seattle-wa', 'remote'); empty = US national. salaries returns valid locations[].

**Returns:** salary{job_title, category, location, average_base_salary_usd, additional_cash_compensation_usd, total_compensation_usd, median_base_usd, min_base_usd, max_base_usd, percentile_10..90_usd, distribution[], by_experience[], by_gender[], by_company_size[], skills[], recent_reports[], locations[], related_titles[]}

**Example request body:**
```json
{
  "job_title": "data engineer"
}
```

### POST https://api.reefapi.com/builtin/v1/articles — 1 credit
Built In articles: the latest stories, or every article under a topic tag with real pagination (10 per page).

**Parameters:**
- `tag` (string, optional) — Topic tag slug (builtin.com/tag/<tag>), e.g. artificial-intelligence, data-science, fintech, software-engineering, editors-picks. Empty = latest articles (one page).
- `page` (integer, optional, default 1) — Page of the tag listing.

**Returns:** articles[]{article_id, title, url, author, date_label, date_type, date, excerpt, tags[], image_url} + meta.pagination

**Example request body:**
```json
{
  "tag": "artificial-intelligence"
}
```

### POST https://api.reefapi.com/builtin/v1/article — 1 credit
One Built In article: title, description, authors, reviewer, dates, tags, summary, full text and the companies it links to.

**Parameters:**
- `url` (string, required) — Article URL (from articles / company-articles) or its path.

**Returns:** article{article_id, url, title, description, authors[], reviewed_by, date_published, date_modified, last_reviewed, image_url, tags[], summary, text, companies_mentioned[]}

**Example request body:**
```json
{
  "url": "https://builtin.com/articles/claude-ai"
}
```

### POST https://api.reefapi.com/builtin/v1/best-places-to-work — 1 credit
Built In's Best Places to Work award list for a year, location (US, remote or a metro) and company size: company, industries, about, top perks, an employee quote, employees, location, founded and open jobs, in the page's order.

**Parameters:**
- `year` (integer, optional, default 2026) — Award year (the site publishes 2023-2026).
- `location` (enum, optional, default "us") — us, remote, or a metro. [one of: us, remote, atlanta, austin, boston, charlotte, chicago, colorado, dallas, houston, los-angeles, miami, new-york-city, san-diego, san-francisco, seattle, washington-dc]
- `size` (enum, optional, default "all") — Company size list (US lists only). [one of: all, startup, midsize, large]

**Returns:** awards{title, companies[]{position, name, alias, url, industries[], about, top_perks[], more_perks, employee_quote, employee_quote_by, total_employees, location, founded, open_jobs}}

### POST https://api.reefapi.com/builtin/v1/job-title-suggest — 1 credit
Built In's job-title autocomplete for a few letters (the site returns 10).

**Parameters:**
- `query` (string, required) — The first letters of a job title.

**Returns:** titles[]

**Example request body:**
```json
{
  "query": "data"
}
```

### POST https://api.reefapi.com/builtin/v1/location-suggest — 1 credit
Built In's location autocomplete; with resolve=true the first match is expanded to city, state, country and coordinates (what search uses).

**Parameters:**
- `query` (string, required) — The first letters of a city, state or country.
- `limit` (integer, optional, default 10) — Matches to return (the site caps this at 10).
- `resolve` (boolean, optional, default false) — Also resolve the first match (one more request).

**Returns:** locations[]{place_id, text} + resolved{city, state, country, latitude, longitude, postal_code}

**Example request body:**
```json
{
  "query": "austin"
}
```

### POST https://api.reefapi.com/builtin/v1/filters — 0 credits
Every filter value Built In uses: job categories and subcategories, experience levels, industries, company sizes, remote options, posted-date windows, search radii, city sites, company-directory regions, perks, tech stack, DEI options, insight topics and award locations. No upstream call.

**Parameters:** none

**Returns:** taxonomies

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=builtin
- Human docs page: https://reefapi.com/docs/builtin
- Overview page: https://reefapi.com/builtin-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
