# BuiltIn Jobs Scraper (`devilscrapes/builtin-jobs-scraper`) Actor

Scrape tech and startup job listings from builtin.com by keyword, city, or category. Get title, company, location, work mode, salary band, seniority, top skills, categories, and posted date in structured rows.

- **URL**: https://apify.com/devilscrapes/builtin-jobs-scraper.md
- **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

<div align="center">
  <img src=".actor/icon.svg" width="160" alt="Devil Scrapes mark" />

## BuiltIn Jobs Scraper

**💰 $1.52 / 1 000 results**  ·  pay only for results  ·  no credit card to try

*We do the dirty work so your dataset stays clean.* 😈

Scrape tech and startup job listings from builtin.com by keyword, city, or category. Get title, company, location, work mode, salary band, seniority, top skills, categories, and posted date in structured rows.

</div>

***

### 🎯 What this scrapes

BuiltIn (builtin.com) is a tech/startup job-listing aggregator that pulls in postings from thousands of employers — not a single company's own careers page. This Actor scrapes builtin.com/jobs and its keyword/category/city filter variants into structured rows: title, company, location(s), work mode (remote/hybrid/onsite), salary band, seniority, category tags, top skills, and a description snippet. Built on `curl-cffi` with browser TLS impersonation and Apify Proxy rotation.

### 🔥 What we handle for you

- 🛡️ **Browser fingerprint rotation** — `curl-cffi` impersonates real Chrome / Firefox / Safari TLS handshakes so the target sees a browser, not Python.
- 🌐 **Residential proxy rotation** via Apify Proxy — fresh session and exit IP on every block.
- 🔁 **Retries with exponential backoff** on `408 / 429 / 5xx` — up to 5 attempts per page, `Retry-After` honoured.
- 🧱 **Rate-limit-aware pacing** — when the target pushes back, we slow down instead of getting banned.
- 🧊 **Clean, typed dataset rows** — Pydantic-validated, ISO-8601 timestamps, stable IDs, JSON / CSV / Excel export straight from the Apify Console.
- 💰 **Pay-Per-Event pricing** — you only pay for results that hit your dataset. No data, no charge.

### 💡 Use cases

- **Recruiting-agency sourcing** — surface fresh tech/startup roles across many employers in one feed, filterable by keyword, city, or category.
- **Talent-market research** — track salary bands, seniority mix, and remote/hybrid/onsite split for a given role or region.
- **Sales intel for HR-tech vendors** — spot companies actively hiring for a target function as a buying signal.
- **Competitive hiring watch** — monitor a category or city's job volume and salary trends over time.
- **Job-board aggregation** — feed a normalized BuiltIn slice into a broader multi-source job dataset.

### ⚙️ How to use it

1. Click **Try for free** at the top of the page.
2. Fill in the input form — most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API.

### 📥 Input

| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `search` | `string` | no | 'engineer' | Keyword search term, e.g. <code>engineer</code>. Matches BuiltIn's <code>?search=</code> query param. Leave empty to… |
| `city` | `string` | no | '—' | City filter, free text or slug (e.g. <code>Austin, TX</code> or <code>austin-tx</code>) — normalized automatically.… |
| `category` | `string` | no | '—' | BuiltIn category filter, free text or slug (e.g. <code>Data Science</code> or <code>data-science</code>) — normalized… |
| `maxResults` | `integer` | no | 100 | Cap on emitted rows (~25 job cards per page). Pagination stops once this cap is reached, even mid-page. |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True} | Apify Proxy configuration. No anti-bot signal observed on this target — the default shared/datacenter pool is… |

#### Example input

```json
{
  "search": "engineer",
  "city": null,
  "category": null,
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

### 📤 Output

Every row is one dataset item.

| Field | Type | Notes |
|---|---|---|
| `job_id` | `string` | Numeric ID suffix of the job URL / card's data-builtin-track-job-id. |
| `title` | `string` | Job title. |
| `url` | `string` | Absolute URL to the job posting on builtin.com. |
| `company_name` | `string` | Hiring company name. |
| `company_url` | `['string', 'null']` | Absolute URL to the company's builtin.com profile; null if the card lacks the link. |
| `company_logo_url` | `['string', 'null']` | Company logo image URL. |
| `location` | `string` | Raw location text, e.g. 'Olathe, KS, USA' or '3 Locations'. |
| `locations` | `array` | Parsed list of individual locations when the card shows 'N Locations'; otherwise a single-element list matching… |
| `work_mode` | `string` | One of Remote, Hybrid, Onsite, or Not specified. |
| `posted_text` | `string` | Raw relative-time text, e.g. '7 Minutes Ago'. |
| `posted_at_estimate` | `['string', 'null']` | ISO-8601 timestamp computed from posted\_text; null if unparseable. |
| `salary_raw` | `['string', 'null']` | Raw salary text, e.g. '142K-204K Annually'; null if no salary is listed. |
| `salary_min` | `['integer', 'null']` | First number in salary\_raw, K/M suffix expanded. |
| `salary_max` | `['integer', 'null']` | Second number in salary\_raw, or equal to salary\_min if only one number is present. |
| `seniority` | `['string', 'null']` | Seniority level, e.g. 'Senior level'. |
| `categories` | `array` | Job category tags (may be empty). |
| `top_skills` | `array` | Top skill tags (may be empty). |
| `description_snippet` | `string` | Plain-text description excerpt (may be empty). |

#### Example output

```json
{
  "job_id": "10451551",
  "title": "Sr. Finance Manager, Supply Chain",
  "url": "https://builtin.com/job/sr-finance-manager-supply-chain/10451551",
  "company_name": "Aerospace Corporation",
  "company_url": "https://builtin.com/company/aerospace-corporation",
  "company_logo_url": "https://cdn.builtin.com/logos/aerospace-corp.png",
  "location": "El Segundo, CA, USA",
  "locations": [
    "El Segundo, CA, USA"
  ],
  "work_mode": "Hybrid",
  "posted_text": "7 Minutes Ago",
  "posted_at_estimate": "2026-07-30T14:23:00Z",
  "salary_raw": "142K-204K Annually",
  "salary_min": 142000,
  "salary_max": 204000,
  "seniority": "Senior level",
  "categories": [
    "Aerospace",
    "Machine Learning",
    "Cybersecurity",
    "Defense"
  ],
  "top_skills": [
    "Excel",
    "SAP",
    "Forecasting"
  ],
  "description_snippet": "The Aerospace Corporation is seeking a Senior Finance Manager..."
}
```

### 💰 Pricing

Pay-Per-Event — you pay only when these events fire:

| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.02 | One-off warm-up charge per run |
| `result` | $0.0015 | Per dataset item |

Example: 1 000 results at the rates above ≈ **$1.52**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.

### 🚧 Limitations

BuiltIn shows roughly 25 job cards per page; large result sets paginate accordingly and pagination stops as soon as a page is empty or repeats the previous page's job IDs. There is no enumerated city/category taxonomy — free text is passed through and resolved by the target, so a typo'd filter silently returns zero rows rather than an error. Only fields present on the listing card itself are captured; this Actor does not follow through to each job's own detail page or the employer's company profile.

### ❓ FAQ

**Does this cover every BuiltIn city and category?**

Free-text <code>city</code>/<code>category</code> values are slugified and passed straight to builtin.com. An unmatched slug returns zero rows (a valid empty filter), not an error.

**Why is <code>salary\_raw</code> sometimes null?**

Not every listing publishes a salary band on builtin.com. When the card has no salary line, <code>salary\_raw</code>/<code>salary\_min</code>/<code>salary\_max</code> are all null.

**What does <code>work\_mode</code> return when it's unclear?**

Unrecognized or missing work-mode text falls back to <code>"Not specified"</code> rather than guessing.

**Can I combine search, city, and category?**

Yes. <code>category</code> and <code>city</code> are path segments; <code>search</code> is a query param (moving <code>city</code> alongside it when both are set). Combining <code>search</code> with a <code>category</code> path is supported but its narrowing behavior is unverified — worst case is an unfiltered-by-category result, never an error.

**How fresh is <code>posted\_at\_estimate</code>?**

Computed from BuiltIn's own relative-time text (e.g. '7 Minutes Ago') at the moment your run executes. Phrasing outside the known patterns leaves it null while <code>posted\_text</code> keeps the raw string.

### 💬 Your feedback

Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.

***

<div align="center">

Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.

</div>

# Actor input Schema

## `search` (type: `string`):

Keyword search term, e.g. <code>engineer</code>. Matches BuiltIn's <code>?search=</code> query param. Leave empty to browse without a keyword filter.

## `city` (type: `string`):

City filter, free text or slug (e.g. <code>Austin, TX</code> or <code>austin-tx</code>) — normalized automatically. Leave empty to skip.

## `category` (type: `string`):

BuiltIn category filter, free text or slug (e.g. <code>Data Science</code> or <code>data-science</code>) — normalized automatically. An unmatched category returns zero results rather than an error.

## `maxResults` (type: `integer`):

Cap on emitted rows (~25 job cards per page). Pagination stops once this cap is reached, even mid-page.

## `proxyConfiguration` (type: `object`):

Apify Proxy configuration. No anti-bot signal observed on this target — the default shared/datacenter pool is sufficient.

## Actor input object example

```json
{
  "search": "engineer",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

All dataset items as JSON.

## `datasetItemsCsv` (type: `string`):

Same data exported to CSV.

## `datasetView` (type: `string`):

Open the run dataset in the Console.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "search": "engineer",
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/builtin-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "search": "engineer",
    "maxResults": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/builtin-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "search": "engineer",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call devilscrapes/builtin-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=devilscrapes/builtin-jobs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/kOHR12Dd1URQJLOfN/builds/xOU06pbvZU3PYTM1K/openapi.json
