# The Muse Jobs Scraper - Postings, Companies & Locations (`scrapers_lat/themuse-jobs-scraper`) Actor

Scrape The Muse job postings with title, company name and id, locations, category, experience level, remote flag, publication date, apply URL and full description. Filter by category, company, location and level. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/themuse-jobs-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Jobs, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.80 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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

[![The Muse Jobs Scraper - Postings, Companies & Locations](https://scrapers.lat/banners/themuse-jobs-scraper.png)](https://console.apify.com/actors/b3FdiUNonvse6wRhB/input)

## The Muse Jobs Scraper - Postings, Companies & Locations

Here is one real result, with every field the actor returns (the `description` text is trimmed here for readability; the live record returns the full posting):

```json
{
  "title": "Counterparty Credit Risk Manager",
  "companyName": "Bank of America",
  "companyId": 12145,
  "companyShortName": "bankofamerica",
  "category": "Software Engineering",
  "categories": ["Software Engineering"],
  "experienceLevel": "Senior Level",
  "primaryLocation": "New York, NY",
  "locations": ["New York, NY"],
  "remote": false,
  "jobType": "external",
  "publicationDate": "2026-04-07T19:29:32Z",
  "applyUrl": "https://www.themuse.com/jobs/bankofamerica/counterparty-credit-risk-manager-13cbf1",
  "jobId": "21529968",
  "shortName": "counterparty-credit-risk-manager-13cbf1",
  "tags": ["Fortune 1000"],
  "description": "Job Description: At Bank of America, we are guided by a common purpose to help make financial lives better through the power of every connection. [trimmed] Pay range $140,000.00 - $219,700.00 annualized salary, offers to be determined based on experience, education and skill set.",
  "source": "The Muse",
  "observedAt": "2026-08-10T14:29:25.260Z",
  "companySize": "Large Size",
  "companyIndustries": ["Financial Services"],
  "companyProfileUrl": "https://www.themuse.com/companies/bankofamerica",
  "companyDescription": "Bank of America provides people, companies, and institutional investors with industry-leading financial products and services.",
  "companyTwitter": null,
  "companyLogo": "https://assets.themuse.com/uploaded/companies/12145/small_logo.png?v=99e0494ccb185d77ecfeca617e25b8e7f7da7b92ff38f7c52d20148a2be3a74f"
}
```

The most complete The Muse job scraper available. It returns every field the public job posting exposes, enriches each job with the hiring company's profile (size, industries, description, logo, social handle), and gives you five filters plus an optional contact-enrichment add-on to target exactly the postings you need.

**📥 [Input](https://apify.com/scrapers_lat/themuse-jobs-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/themuse-jobs-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/themuse-jobs-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/themuse-jobs-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-Global-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor queries The Muse public job listings, applies the filters you pass as input (category, company, location, experience level, and a free-text keyword), paginates through the matching postings, and writes one normalized record per job to the run's dataset. HTML descriptions are converted to clean plain text, missing source values are returned as `null`, and each job is enriched with its company profile (size, industries, description, logo, Twitter/X handle) so you get hiring context without a second lookup. Jobs are de-duplicated by job ID across pages.

An optional paid add-on can attempt to find a public business contact email and contact name for each result.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns the 10 most recent Software Engineering postings.

```json
{
  "categories": ["Software Engineering"],
  "maxJobs": 10,
  "enrichContacts": false,
  "enrichContactsMax": 50
}
```

Every input field is optional. With an empty input the actor returns recent postings across all categories (default `maxJobs` is 50, capped at 10 on free Apify plans).

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `categories` | string\[] | no | (any) | Filter by job category, for example `Software Engineering`, `Data Science`, `Marketing`, `Sales`. Add one or more; empty searches all categories. |
| `companyNames` | string\[] | no | (any) | Restrict to one or more companies by their profile short name on The Muse, for example `uber`, `bankofamerica`. |
| `locations` | string\[] | no | (any) | Filter by location, for example `New York, NY`, `London, England`, or `Flexible / Remote` for remote roles. |
| `levels` | string\[] | no | (any) | Filter by experience level, for example `Entry Level`, `Mid Level`, `Senior Level`, `Management`. |
| `keyword` | string | no | (empty) | Keep only jobs whose title, company, or description contains this text, for example `python`, `nurse`, `remote`. |
| `maxJobs` | integer | no | `50` | Maximum number of postings to collect. Free Apify plans are capped at 10 per run. |
| `enrichContacts` | boolean | no | `false` | Paid add-on. For each result without an email, attempt to find a public business contact email and contact name. Billed per attempt, plus an extra charge only when an email is found. |
| `enrichContactsMax` | integer | no | `50` | Cap how many results the add-on tries to enrich, to control add-on cost. Free Apify accounts are capped at 3. |

Filters combine with logical AND.

### Output reference

One dataset item per job posting. Types: `string`, `integer`, `boolean`, `string[]`, or `null` when the source value is absent.

| Field | Type | Description |
|---|---|---|
| `title` | string | Job title. |
| `companyName` | string | Hiring company name. |
| `companyId` | integer | The Muse company ID. |
| `companyShortName` | string | Company profile short name (slug). |
| `category` | string | Job categories joined into a single string. |
| `categories` | string\[] | Job categories as a list. |
| `experienceLevel` | string | Experience level(s) for the role. |
| `primaryLocation` | string | First listed location. |
| `locations` | string\[] | All listed locations. |
| `remote` | boolean | `true` when a location names remote or flexible. |
| `jobType` | string | Posting type reported by the source, for example `external`. |
| `publicationDate` | string | ISO 8601 publication date. |
| `applyUrl` | string | Landing page / apply URL for the posting. |
| `jobId` | string | The Muse job ID (unique per posting). |
| `shortName` | string | Job slug. |
| `tags` | string\[] | Job tags, for example `Fortune 1000`. |
| `description` | string | Full job description as plain text. |
| `source` | string | Always `The Muse`. |
| `observedAt` | string | ISO 8601 timestamp of when the record was collected. |
| `companySize` | string | Company size band, for example `Large Size`. |
| `companyIndustries` | string\[] | Company industries. |
| `companyProfileUrl` | string | Company profile page URL. |
| `companyDescription` | string | Company description as plain text. |
| `companyTwitter` | string | Company Twitter/X handle, or `null`. |
| `companyLogo` | string | Company logo image URL. |
| `enrichedEmail` | string | Contact email found by the add-on (only when `enrichContacts` is on). |
| `enrichedContactName` | string | Contact person's name found by the add-on. |
| `enrichedJobTitle` | string | Contact person's job title found by the add-on. |
| `enrichedEmailStatus` | string | Deliverability status of the enriched email. |
| `enrichedSource` | string | Source URL the enriched contact was found on. |
| `enrichedConfidence` | string | Confidence label for the enriched contact. |
| `error` | string | `null` on success. On a failed run, a single item with a populated `error` field is written instead. |

### Example output record

Real record from a live run (input `{"categories": ["Software Engineering"], "maxJobs": 10}`), with the `description` trimmed for readability (the live record returns the full posting text):

```json
{
  "title": "Counterparty Credit Risk Manager",
  "companyName": "Bank of America",
  "companyId": 12145,
  "companyShortName": "bankofamerica",
  "category": "Software Engineering",
  "categories": ["Software Engineering"],
  "experienceLevel": "Senior Level",
  "primaryLocation": "New York, NY",
  "locations": ["New York, NY"],
  "remote": false,
  "jobType": "external",
  "publicationDate": "2026-04-07T19:29:32Z",
  "applyUrl": "https://www.themuse.com/jobs/bankofamerica/counterparty-credit-risk-manager-13cbf1",
  "jobId": "21529968",
  "shortName": "counterparty-credit-risk-manager-13cbf1",
  "tags": ["Fortune 1000"],
  "description": "Job Description: At Bank of America, we are guided by a common purpose to help make financial lives better through the power of every connection. [trimmed]",
  "source": "The Muse",
  "observedAt": "2026-08-10T14:29:25.260Z",
  "companySize": "Large Size",
  "companyIndustries": ["Financial Services"],
  "companyProfileUrl": "https://www.themuse.com/companies/bankofamerica",
  "companyDescription": "Bank of America provides people, companies, and institutional investors with industry-leading financial products and services.",
  "companyTwitter": null,
  "companyLogo": "https://assets.themuse.com/uploaded/companies/12145/small_logo.png?v=99e0494ccb185d77ecfeca617e25b8e7f7da7b92ff38f7c52d20148a2be3a74f"
}
```

### Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace `<TOKEN>` with your Apify API token.

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~themuse-jobs-scraper/run-sync-get-dataset-items?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"categories":["Software Engineering"],"levels":["Senior Level"],"maxJobs":25}'
```

Start a run asynchronously:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~themuse-jobs-scraper/runs?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"companyNames":["uber"],"maxJobs":100}'
```

Apify CLI:

```bash
apify call scrapers_lat/themuse-jobs-scraper \
  --input '{"categories":["Data Science"],"locations":["Flexible / Remote"],"maxJobs":50}'
```

### Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`:

```bash
## JSON
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=json"

## CSV
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=csv"

## Paginate large datasets
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&offset=1000&limit=1000"
```

`<DATASET_ID>` is returned as `defaultDatasetId` in the run object. Use `offset` and `limit` to page through large result sets. `clean=true` drops empty and internal fields.

### Billing and limits

- **Pay per result.** You are charged per record returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/themuse-jobs-scraper/pricing) for the current per-result price.
- **Contact enrichment add-on.** When `enrichContacts` is on, the add-on is billed per attempt, plus an extra charge only when an email is found. It is off by default.
- **No charge on failure.** If a run errors, the actor writes a single item with a populated `error` field and does not charge for it. Empty runs cost nothing.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 records per run (and 3 contact-enrichment attempts). Upgrade for higher `maxJobs`.

### FAQ and troubleshooting

**A run returned 0 records. Why?**
The filter combination matched nothing. Loosen filters (for example remove `locations` or `levels`), or check the exact category and short-name spelling. Zero-result runs are not charged.

**How do I get only remote jobs?**
Set `locations` to `Flexible / Remote`, or set a `keyword` of `remote`. The `remote` output field is also `true` when a location names remote or flexible work.

**How do I target one company?**
Pass its profile short name in `companyNames`, for example `bankofamerica`. The short name is the slug in the company's The Muse profile URL.

**Why is `companyTwitter` null?**
The company did not list a Twitter/X handle on its The Muse profile. Missing source values are returned as `null`, never invented.

**How do I get contact emails?**
Turn on `enrichContacts`. For each result without an email the add-on tries to find a public business contact email and name. It is a paid add-on and billed separately.

**Is this an official The Muse tool?**
No. This actor is independent and has no affiliation with The Muse. It reads only data that is publicly available on The Muse. Use it in accordance with The Muse terms of service.

### Related scrapers

- [Greenhouse Jobs Scraper](https://apify.com/scrapers_lat/greenhouse-jobs-scraper): job postings from Greenhouse-hosted career pages.
- [Ashby Jobs Scraper](https://apify.com/scrapers_lat/ashby-jobs-scraper): job postings from Ashby-hosted career pages.
- [BambooHR Jobs Scraper](https://apify.com/scrapers_lat/bamboohr-jobs-scraper): job postings from BambooHR career sites.
- [Breezy HR Jobs Scraper](https://apify.com/scrapers_lat/breezy-hr-jobs-scraper): job postings from Breezy HR career pages.
- [Dice Jobs Scraper](https://apify.com/scrapers_lat/dice-jobs-scraper): US tech job postings from Dice.
- [Himalayas Remote Jobs Scraper](https://apify.com/scrapers_lat/himalayas-scraper): remote job postings from Himalayas.

### More scrapers at scrapers.lat

Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> Independent tool, not affiliated with The Muse. Accesses only publicly available job listing data. Use in accordance with The Muse terms of service.

# Actor input Schema

## `categories` (type: `array`):

Filter jobs by category, for example 'Software Engineering', 'Data Science', 'Marketing', 'Sales'. Add one or more. Leave empty to search all categories.

## `companyNames` (type: `array`):

Optional. Restrict to one or more companies by their profile short name on The Muse (for example 'uber', 'bankofamerica').

## `locations` (type: `array`):

Optional. Filter by location, for example 'New York, NY', 'London, England', or 'Flexible / Remote' for remote roles.

## `levels` (type: `array`):

Optional. Filter by experience level, for example 'Entry Level', 'Mid Level', 'Senior Level', 'Management'.

## `keyword` (type: `string`):

Optional. Keep only jobs whose title, company or description contains this text (for example 'python', 'nurse', 'remote').

## `maxJobs` (type: `integer`):

Maximum number of job postings to collect. Optional.

## `enrichContacts` (type: `boolean`):

Optional paid add-on, off by default. For each result without an email, attempt to find a public business contact email and a contact person's name. Billed per attempt, plus an extra charge only when an email is found.

## `enrichContactsMax` (type: `integer`):

Cap how many results the add-on tries to enrich, to control add-on cost. Leave empty to attempt all. Free Apify accounts are capped at 3.

## Actor input object example

```json
{
  "categories": [
    "Software Engineering"
  ],
  "maxJobs": 10,
  "enrichContacts": false,
  "enrichContactsMax": 50
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "categories": [
        "Software Engineering"
    ],
    "maxJobs": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/themuse-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 = {
    "categories": ["Software Engineering"],
    "maxJobs": 10,
}

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

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

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

```

## CLI example

```bash
echo '{
  "categories": [
    "Software Engineering"
  ],
  "maxJobs": 10
}' |
apify call scrapers_lat/themuse-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/themuse-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/b3FdiUNonvse6wRhB/builds/ex8J5VTsYSFb6hNl1/openapi.json