# Job Posting Extractor: Job Ads of Any Web Page (`arnaud437/job-posting-extractor`) Actor

Job ads of any web page that marks them up for Google (schema.org JobPosting): title, company, city, country, contract, salary, date and full description.

- **URL**: https://apify.com/arnaud437/job-posting-extractor.md
- **Developed by:** [Open Data Tools](https://apify.com/arnaud437) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 job extracteds

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Job Posting Extractor: Job Ads of Any Web Page

Read the **job ads of any web page** that marks them up for Google Jobs (**schema.org JobPosting**): **title**, **company**, **city** and **country**, **remote**, **contract type**, **salary**, **publication date** and the **full description**, in clean **JSON**. Works on careers pages, job boards and recruiting software pages alike, thousands of links at a time. **$1.00 per 1,000 jobs**.

### What you get

One row per job ad found on a page:

- **Job**: title, contract type (full-time, part-time, contract, temporary, internship), remote when said, salary when published, the publisher's job number.
- **Company**: the hiring company's name.
- **Place**: city, region, country (ISO code), every location of the job.
- **Dates**: publication date.
- **Links**: the job link and the page read.
- **Description** as Markdown, without emails or phone numbers.

A page without a job ad gives a free error row. Job ads written into the page by a script after loading are not seen: the Actor reads pages like a search engine does, without a browser.

### Use cases

- **Job boards and aggregators**: the same clean format for job ads from thousands of employer sites.
- **Sales prospecting**: who hires for which role, read from the companies' own pages.
- **Recruiting agencies**: follow the openings of the companies you work with.
- **SEO checks**: see what Google Jobs reads from your own job pages.

### How to use

- **Pages**: links of job ad pages or careers pages. Up to 10,000.
- **Job descriptions**: on by default; turn off for lighter rows.

For companies on Workable, Recruitee, Personio or Breezy HR, the dedicated Jobs Scrapers list every open job from the company name alone.

### Input example

```json
{
  "urls": [
    "https://tado.jobs.personio.de/job/2502124",
    "https://embraer.breezy.hr/p/4658211f5c93-a-p-technician"
  ],
  "includeDescription": true
}
```

### Output example

```json
{
  "recordType": "job",
  "id": "tado.jobs.personio.de:2502124-1597",
  "url": "https://tado.jobs.personio.de/job/2502124",
  "pageUrl": "https://tado.jobs.personio.de/job/2502124",
  "domain": "tado.jobs.personio.de",
  "jobId": "2502124-1597",
  "title": "Team Lead Accounting (m/f/d)",
  "companyName": "tado GmbH",
  "department": null,
  "city": "München",
  "region": "Bayern",
  "locations": ["München, Bayern, DE"],
  "workplaceType": null,
  "employmentType": "full-time",
  "salaryText": null,
  "publishedAt": "2026-10-09T00:00:00.000Z",
  "updatedAt": null,
  "jobUrl": "https://tado.jobs.personio.de/job/2502124",
  "applyUrl": null,
  "country": "DE",
  "description": "# What you’ll be up to\n\nYou have a passion for numbers? Taking processes to the next level…",
  "status": "ok",
  "sourceName": "Job ad on tado.jobs.personio.de",
  "sourceUrl": "https://tado.jobs.personio.de/job/2502124",
  "licence": "Job ad its publisher marks up for anyone (schema.org JobPosting), read as robots.txt allows",
  "sourceUpdatedAt": "2026-10-09T00:00:00.000Z",
  "actorVersion": "0.1.1",
  "retrievedAt": "2026-11-20T11:38:27.233Z"
}
```

### Pricing

Pay per event: **$1.00 per 1,000 jobs** (`job-extracted`, $0.001 each), plus Apify's start fee of $0.00005 per run. Pages without a job ad and other error rows are free.

| Jobs                             | Price |
| -------------------------------- | ----- |
| 1,000 job pages                  | $1    |
| 200 job pages, every day a month | $6    |
| 10,000 job pages                 | $10   |

### Data source

The public pages given, read once each with robots.txt respected and no login. Only the schema.org JobPosting markup that publishers add for search engines is read.

### Is it legal?

Yes. Publishers mark up their job ads precisely so that anyone, Google first, can read and show them; each row names its page. No personal data is kept: application contacts are never read, and descriptions are cleaned of emails and phone numbers. Pages closed by robots.txt are not read.

### FAQ

- **Why "no job ad" on a page that shows one?** The page does not mark it up, or adds the markup with a script after loading. Try the page of the job itself rather than the list.
- **Why is a field empty?** The publisher did not fill it in.
- **A list of a company's jobs from its name?** See Workable, Recruitee, Personio and Breezy HR Jobs Scrapers, and Company Jobs.

### Related Actors

- [Lever Jobs Scraper](https://apify.com/arnaud437/lever-jobs): Open Jobs of Any Company
- [Ashby Jobs Scraper](https://apify.com/arnaud437/ashby-jobs): Open Jobs of Any Company
- [Workable Jobs Scraper](https://apify.com/arnaud437/workable-jobs): Open Jobs of Any Company
- [Recruitee Jobs Scraper](https://apify.com/arnaud437/recruitee-jobs): Open Jobs of Any Company
- [Startup Funding Rounds](https://apify.com/arnaud437/startup-funding-sec): US Fundraising from SEC Form D

Every Actor here also works as a tool for AI agents (Claude, ChatGPT, Cursor…) through [Apify’s MCP server](https://mcp.apify.com).

### Changelog

See [CHANGELOG.md](CHANGELOG.md).

### En français

#### Les offres d'emploi de n'importe quelle page

Lit les offres d'emploi que les sites balisent pour Google (schema.org JobPosting) : intitulé, entreprise, ville, pays, télétravail, contrat, salaire, date et description, à partir d'une liste de liens.

#### Prix

1 $ les 1 000 offres. Les pages sans offre sont gratuites.

#### Source et légalité

Les pages publiques données, robots.txt respecté. Aucune donnée personnelle : ni contact de candidature, ni email, ni téléphone.

# Changelog

This Actor's version history is a separate document: https://apify.com/arnaud437/job-posting-extractor/changelog.md

# Actor input Schema

## `urls` (type: `array`):

Links of job ad pages or careers pages (acme.com/jobs/data-engineer). Every job ad marked up on the page is read. Up to 10,000.

## `includeDescription` (type: `boolean`):

Add the full job description, as Markdown, without emails or phone numbers.

## Actor input object example

```json
{
  "urls": [
    "https://tado.jobs.personio.de/job/2502124",
    "https://embraer.breezy.hr/p/4658211f5c93-a-p-technician"
  ],
  "includeDescription": true
}
```

# Actor output Schema

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

One row per job ad: title, company, place, contract, salary, dates and description.

## `summary` (type: `string`):

Jobs extracted, error rows, and dates of the run.

# 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 = {
    "urls": [
        "https://tado.jobs.personio.de/job/2502124",
        "https://embraer.breezy.hr/p/4658211f5c93-a-p-technician"
    ],
    "includeDescription": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("arnaud437/job-posting-extractor").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 = {
    "urls": [
        "https://tado.jobs.personio.de/job/2502124",
        "https://embraer.breezy.hr/p/4658211f5c93-a-p-technician",
    ],
    "includeDescription": True,
}

# Run the Actor and wait for it to finish
run = client.actor("arnaud437/job-posting-extractor").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 '{
  "urls": [
    "https://tado.jobs.personio.de/job/2502124",
    "https://embraer.breezy.hr/p/4658211f5c93-a-p-technician"
  ],
  "includeDescription": true
}' |
apify call arnaud437/job-posting-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,arnaud437/job-posting-extractor"
        }
    }
}
```

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/I58f0xU5zayXOX2xF/builds/IhRKcZEUH7k2OBfCG/openapi.json
