# Pinpoint Jobs Scraper (`compass_lab/pinpointhq-jobs-scraper`) Actor

Pinpoint jobs scraper and API: export every open job from any company's Pinpoint careers site (title, department, location, workplace type, employment type, salary range where published, date) to JSON, CSV or Excel. Public postings feed, no login, many filters. Track new, changed and closed jobs.

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

## Pricing

Pay per event

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/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

**Get Pinpoint job listings as clean JSON, CSV or Excel, from the Apify API or on a schedule. No login, about $1.00 for 1,000 jobs, $2.50 with full descriptions.**

### What does Pinpoint Jobs Scraper do?

**Pinpoint Jobs Scraper** extracts structured data from **[field.pinpointhq.com](https://field.pinpointhq.com)**. Collect public job postings from Pinpoint-hosted career sites (pinpointhq.com) as clean, typed and validated records, with filters and pagination, for job monitoring and market analysis. It works
as an **API for field.pinpointhq.com data**: run it from Apify Console, on a schedule, or from your own code, and get clean,
typed JSON with numbers as numbers and dates in ISO 8601.

### What you get

| | |
|---|---|
| **Data** | 15 fields per item: `url`, `id`, `title`, `company`, `location`, `department`, ... |
| **Formats** | JSON, CSV, Excel, HTML, or the Apify API |
| **Price** | $1.00 per 1,000 jobs, $2.50 with full descriptions, pay per result |
| **Access** | Public field.pinpointhq.com data only: no login, no cookies, robots.txt respected |

### Why use Pinpoint Jobs Scraper?

- **Recruiters and staffing agencies**: see which companies are hiring, for which roles and where, and reach out first.
- **Job aggregators and job boards**: feed fresh, de-duplicated listings into your own board on a schedule.
- **Market research and HR analytics**: track hiring trends, salaries (where published), locations and remote share.
- **AI agents and RAG**: give an LLM live, structured job data instead of stale web pages.

Main features:

- Follows pagination up to `maxPages` pages per start URL and stops at `maxItems` results.
- Filters: `companies` (companies), `keywords` (keywords), `excludeKeywords` (exclude keywords), `location` (location filter), `remoteOnly` (remote only), `postedAfter` (posted after), `searchQuery` (keyword filter), `employmentType` (employment type filter), `onlyChanges` (only changes since the last run), `includeDescription` (include description), `onlyNewSinceLastRun` (only new jobs since the last run), so you only get (and pay for) the results you need.
- Polite by default: respects robots.txt, at most `maxConcurrency` parallel requests and a delay between requests.
- Checks every result against field validators, so layout changes show up as clear data-quality warnings.
- Runs on the Apify platform: scheduling, API access, integrations, monitoring and datasets you can export.

### What data can Pinpoint Jobs Scraper extract?

| Field | Type | Description |
|---|---|---|
| `url` | string | Public URL of the job posting |
| `id` | string | Pinpoint posting identifier |
| `title` | string | Job title |
| `company` | string | Hiring company name (from the career site) |
| `location` | string | Job location (city, region, country) as a single text |
| `department` | string | Department or job function |
| `employmentType` | string | Employment type such as full_time, part_time or contract |
| `workplaceType` | string | Workplace arrangement such as onsite, hybrid or remote |
| `salaryMin` | number | Minimum advertised salary, if published |
| `salaryMax` | number | Maximum advertised salary, if published |
| `salaryCurrency` | string | Currency code of the salary, e.g. GBP, USD |
| `description` | string | Job description as plain text (HTML stripped) |
| `postedAt` | ISO 8601 date | Date the job was published or last updated (ISO 8601), if available |
| `changeType` | string | new, changed, unchanged, closed since the last run with the same input |
| `changes` | object | What changed since the last run: {field: {from, to}} |

### How to scrape field.pinpointhq.com

1. Open Pinpoint Jobs Scraper in Apify Console and go to the Input tab.
2. Enter what to scrape (see the Input section below), for example the start URLs.
3. Set **Max items** to the number of results you need.
4. Click **Start** and wait for the run to finish.
5. Download the results from the Output tab, or fetch them with the API.

### How much will it cost to scrape field.pinpointhq.com?

This Actor is priced **per result**: $1.00 per 1,000 results, with no extra charge for platform usage. That is about $1.00 for 1,000 jobs, $2.50 with full descriptions: 100 results cost $0.10 and 10,000 results cost $10.00. Set a maximum cost per run and the Actor stops when it is reached. With **Include description** on, each job comes with its full description text and is priced **$2.50 per 1,000 results** (job with description). Filters (companies, keywords, location, remote only, posted after, only new jobs) run **before** charging: you never pay for jobs you filtered out.

### Input

See the Input tab for full configuration options.

| Field | Type | Required | Description |
|---|---|---|---|
| `companies` | array | no | Company names (e.g. Stripe) or job board URLs. Each name is looked up on Pinpoint; names that can't be found are logged and skipped. |
| `keywords` | array | no | Keep jobs whose title (and description, when 'Include description' is on) contains any of these words. Case-insensitive. |
| `excludeKeywords` | array | no | Drop jobs whose title (and description, when on) contains any of these words. |
| `location` | string | no | Only return jobs whose location (city, province or country) contains this text. |
| `remoteOnly` | boolean | no | Keep only remote jobs (location says Remote/Anywhere, or the source marks the job as remote). |
| `postedAfter` | string | no | Keep jobs posted on or after this date (YYYY-MM-DD). Jobs without a date are kept. |
| `searchQuery` | string | no | Only return jobs whose title or description contains this keyword (case-insensitive). Leave empty for all jobs. |
| `employmentType` | string | no | Only return jobs with this employment type, e.g. full_time, part_time, contract. Leave empty for all. |
| `onlyChanges` | boolean | no | For scheduled runs: return (and pay for) only new, changed and closed records, compared with the last run with the same input. The snapshot is kept in a named key-value store; delete it to start over. |
| `includeDescription` | boolean | no | Add the full job description text. Priced as 'job with description'. |
| `onlyNewSinceLastRun` | boolean | no | For scheduled runs: skip jobs this same input already returned. The IDs are kept in a named key-value store; delete it to start over. |
| `maxItems` | integer | no | Maximum number of items to return (0 = unlimited). |
| `startUrls` | array | no | Pinpoint career site postings.json URLs, e.g. https://field.pinpointhq.com/postings.json. A career site root URL is also accepted and /postings.json is appended. |
| `maxPages` | integer | no | Maximum listing pages to follow per start URL (pagination). |
| `maxConcurrency` | integer | no | Maximum parallel requests (politeness; 1-10). |
| `requestDelayMs` | integer | no | Minimum delay between requests, in milliseconds (at least 250). |
| `proxyType` | string | no | none (direct connection), datacenter (Apify Proxy, cheapest) or residential (opt-in, billed per GB, fewer blocks). The actor never switches by itself. |
| `proxyCountry` | string | no | Two-letter country code for the proxy IP (optional). |

Example input:

```json
{
  "startUrls": [
    {
      "url": "https://field.pinpointhq.com/postings.json"
    }
  ],
  "maxItems": 60,
  "maxPages": 3,
  "maxConcurrency": 2,
  "requestDelayMs": 1000,
  "proxyType": "none",
  "includeDescription": true
}
```

### Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Example results
from a real run:

```json
[
  {
    "url": "https://field.pinpointhq.com/en/postings/ec6330da-c5ab-4200-886b-2b9377db1ddf",
    "id": "411240",
    "title": "BESS Engineer",
    "company": "field",
    "location": "Shoreditch, London",
    "department": "DevCon",
    "employmentType": "permanent_full_time",
    "workplaceType": "remote",
    "salaryMin": null,
    "salaryMax": null,
    "salaryCurrency": null,
    "description": "A bit about Field Field is an international developer, owner, operator, of renewable infrastructure. Our Founder and CEO is a successful entrepreneur who previously co-founded a green energy supplier. We have robust pipelines of BESS projects across the UK, Italy, Spain, and Germany - and strong fin…",
    "postedAt": null
  },
  {
    "url": "https://field.pinpointhq.com/en/postings/6ad25fa3-cda3-4968-9cc6-fc9275d80b58",
    "id": "498098",
    "title": "Senior Project Manager (Permitting) - Italy",
    "company": "field",
    "location": "Roma",
    "department": "DevCon",
    "employmentType": "permanent_full_time",
    "workplaceType": "hybrid",
    "salaryMin": 72000,
    "salaryMax": 90000,
    "salaryCurrency": "EUR",
    "description": "A bit about Field To reach Net Zero, we need to solve big problems. Field will fund, build and run the renewable infrastructure we need to tackle these challenges. At Field, we are showing that batteries are a totally viable part of our energy infrastructure - now, not in some distant future. With a…",
    "postedAt": null
  },
  {
    "url": "https://field.pinpointhq.com/en/postings/5788fcd4-d4f6-457e-ab33-2cb5bdcff52f",
    "id": "511800",
    "title": "Assistant Treasurer",
    "company": "field",
    "location": "Shoreditch, London",
    "department": "Finance",
    "employmentType": "permanent_full_time",
    "workplaceType": "hybrid",
    "salaryMin": 100000,
    "salaryMax": 120000,
    "salaryCurrency": "GBP",
    "description": "A bit about Field: Field is an international builder, owner, operator, of renewable infrastructure. Our Founder and CEO is a successful entrepreneur who previously co-founded a green energy supplier. We have robust pipelines of BESS projects across the UK, Italy, Spain, and Germany - and strong fina…",
    "postedAt": null
  }
]
```

### Integrations and API

- **Apify API**: start a run and get the results in one HTTP request:

```bash
curl -X POST "https://api.apify.com/v2/acts/compass_lab~pinpointhq-jobs-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" -d '{"startUrls": [{"url": "https://field.pinpointhq.com/postings.json"}], "maxItems": 60, "includeDescription": true}'
```

- **Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("compass_lab/pinpointhq-jobs-scraper").call(run_input={"startUrls": [{"url": "https://field.pinpointhq.com/postings.json"}], "maxItems": 60, "includeDescription": true})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

- **JavaScript** (`npm install apify-client`):

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('compass_lab/pinpointhq-jobs-scraper').call({"startUrls": [{"url": "https://field.pinpointhq.com/postings.json"}], "maxItems": 60, "includeDescription": true});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

- **Make, Zapier, n8n, Google Sheets, webhooks**: use the Apify integrations (Integrations tab) to send each
  run's results where you need them, or to start a run from your workflow.
- **Schedules**: run it hourly, daily or weekly from Apify Console (Schedules) and always have fresh jobs.

### Tips and advanced options

- Keep **Max items** and **Max pages** as low as you need: fewer pages means a faster, cheaper run.
- Raise **Delay between requests** if the site responds slowly; keep **Max concurrency** low to stay polite.
- Missing values are `null`. Fields that often come back empty are listed in the run log as data-quality warnings.
- **Companies**: type company names (`Stripe`, `Acme Inc`) or paste job board URLs. Names are matched the way
  the platform writes them (`Stripe Inc` -> `stripe`); a company that can't be found is named in the log and skipped.
- **Daily monitoring**: schedule the Actor with **Only new jobs since the last run** on. Each run returns only jobs
  it hasn't returned before for the same input. The IDs are kept in a named key-value store called
  `<actor-name>-seen-<id>` (the run log prints its name); delete that store in Storage > Key-value stores, or change
  the input, to start over.
- **Filters before charging**: keywords, exclude keywords, location, remote only and posted after are applied before
  a job is saved, so filtered-out jobs cost nothing.

### Track changes

Schedule the Actor (for example every morning) with **Only changes since the last run** on. Each run then returns,
and charges for, only the jobs that moved since the previous run with the same input:

- `new`: a job this input hadn't returned before;
- `changed`: same job, but its title, location, salary, type or department changed; `changes` says what, e.g.
  `{"salaryMax": {"from": 90000, "to": 100000}}`;
- `closed`: a job returned last time that is gone now (charged like a job). Closed jobs are reported only when the
  run read the whole board: raise **Max pages** if a board has more pages than it allows.

Without that option every job is returned as usual, each marked `new`, `changed` or `unchanged`.

Add it to your usual input, e.g. `"onlyChanges": true`.

The last snapshot is kept in a named key-value store called `<actor-name>-watch-<id>` (the run log prints its name).
To start over, delete that store in Storage > Key-value stores, or change the input. **Only new jobs since the last
run** still works as before (new jobs only, its own store).

### FAQ, disclaimers and support

#### Is it legal to scrape field.pinpointhq.com?

Vetted by the autonomy policy (green tier) on 2026-10-01: Green tier (autonomy policy, 2026-10-01): robots.txt exists and permits /postings.json (no matching Disallow); public endpoint; platform family 'ats-job-boards' confirmed by Mouad on 2026-10-01: Checked vendor terms: clauses cover customer use, public job boards are meant to be read

Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location.
They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used
for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain
personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the
world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether
your reason is legitimate, consult your lawyers.

#### How many results can I get?

Up to `maxItems` per run (0 means no limit), as many as the source lists. Each result is one dataset item, and
you are only charged for items that are saved.

#### Can I run it on a schedule or from my own code?

Yes. Schedule it in Apify Console (Schedules), or call it with the `run-sync-get-dataset-items` endpoint or the
Python/JavaScript clients shown in **Integrations and API** above.

#### What are the limitations?

- Only Pinpoint-hosted career sites are supported; other careers sites and Pinpoint sites with a custom domain may need their /postings.json URL given explicitly.
- Fields such as salary, department and workplace type are only filled when the employer publishes them, so many jobs will have empty values for them.
- If Pinpoint changes the structure of its JSON response, some fields may be empty until the Actor is updated.
- Small career sites hold few jobs, so a single start URL may return fewer items than the max items limit.
- Sending very many requests in a short time may lead to rate limiting by Pinpoint; the Actor keeps request rates low.

#### Where can I get help?

Report problems or ideas on the Issues tab. To call this Actor from your own code, see the API tab.

### Related actors

**Job Boards Suite**: the same clean, typed output across sources, so you can combine them in one dataset.

| Actor | What it scrapes | Price |
|---|---|---|
| [Breezy HR Jobs Scraper](https://apify.com/compass_lab/breezy-jobs-scraper) | Job listings from Breezy HR | $1.00 / 1,000 |
| [Canada Job Bank Jobs Scraper](https://apify.com/compass_lab/canada-jobbank-scraper) | Job listings from Canada Job Bank | $1.00 / 1,000 |
| [Greenhouse Jobs Scraper](https://apify.com/compass_lab/greenhouse-jobs-scraper) | Job listings from Greenhouse | $1.60 / 1,000 |
| [Lever Jobs Scraper](https://apify.com/compass_lab/lever-jobs-scraper) | Job listings from Lever | $1.60 / 1,000 |
| [Python Jobs Scraper (python.org)](https://apify.com/compass_lab/python-job-board-scraper) | Job listings from Python Jobs Scraper (python.org) | $2.00 / 1,000 |
| [Recruitee Jobs Scraper](https://apify.com/compass_lab/recruitee-jobs-scraper) | Job listings from Recruitee | $1.00 / 1,000 |
| [We Work Remotely Jobs Scraper](https://apify.com/compass_lab/weworkremotely-jobs-scraper) | Job listings from We Work Remotely | $2.50 / 1,000 |
| [Working Nomads Jobs Scraper](https://apify.com/compass_lab/workingnomads-jobs-scraper) | Job listings from Working Nomads | $2.50 / 1,000 |

# Actor input Schema

## `companies` (type: `array`):

Company names (e.g. Stripe) or job board URLs. Each name is looked up on Pinpoint; names that can't be found are logged and skipped.

## `keywords` (type: `array`):

Keep jobs whose title (and description, when 'Include description' is on) contains any of these words. Case-insensitive.

## `excludeKeywords` (type: `array`):

Drop jobs whose title (and description, when on) contains any of these words.

## `location` (type: `string`):

Only return jobs whose location (city, province or country) contains this text.

## `remoteOnly` (type: `boolean`):

Keep only remote jobs (location says Remote/Anywhere, or the source marks the job as remote).

## `postedAfter` (type: `string`):

Keep jobs posted on or after this date (YYYY-MM-DD). Jobs without a date are kept.

## `employmentType` (type: `string`):

Only return jobs with this employment type, e.g. full_time, part_time, contract. Leave empty for all.

## `onlyChanges` (type: `boolean`):

For scheduled runs: return (and pay for) only new, changed and closed records, compared with the last run with the same input. The snapshot is kept in a named key-value store; delete it to start over.

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

Add the full job description text. Changes the price: $2.50 per 1,000 jobs instead of $1.00.

## `onlyNewSinceLastRun` (type: `boolean`):

For scheduled runs: skip jobs this same input already returned. The IDs are kept in a named key-value store; delete it to start over.

## `maxItems` (type: `integer`):

Maximum number of items to return (0 = unlimited). You pay per result, so this also caps the cost.

## `startUrls` (type: `array`):

Pinpoint career site postings.json URLs, e.g. https://field.pinpointhq.com/postings.json. A career site root URL is also accepted and /postings.json is appended.

## `maxPages` (type: `integer`):

Maximum listing pages to follow per start URL (pagination).

## `maxConcurrency` (type: `integer`):

Maximum parallel requests (politeness; 1-10).

## `requestDelayMs` (type: `integer`):

Minimum delay between requests, in milliseconds (at least 250).

## `proxyType` (type: `string`):

none (direct connection), datacenter (Apify Proxy, cheapest) or residential (opt-in, billed per GB, fewer blocks). The actor never switches by itself.

## `proxyCountry` (type: `string`):

Two-letter country code for the proxy IP (optional).

## Actor input object example

```json
{
  "companies": [
    "field",
    "digitalscience"
  ],
  "remoteOnly": false,
  "onlyChanges": false,
  "includeDescription": false,
  "onlyNewSinceLastRun": false,
  "maxItems": 20,
  "maxPages": 3,
  "maxConcurrency": 2,
  "requestDelayMs": 1000,
  "proxyType": "none"
}
```

# Actor output Schema

## `dataset` (type: `string`):

All scraped items (overview view)

# 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 = {
    "companies": [
        "field",
        "digitalscience"
    ],
    "includeDescription": false,
    "maxItems": 20,
    "maxPages": 3,
    "maxConcurrency": 2,
    "requestDelayMs": 1000,
    "proxyType": "none"
};

// Run the Actor and wait for it to finish
const run = await client.actor("compass_lab/pinpointhq-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 = {
    "companies": [
        "field",
        "digitalscience",
    ],
    "includeDescription": False,
    "maxItems": 20,
    "maxPages": 3,
    "maxConcurrency": 2,
    "requestDelayMs": 1000,
    "proxyType": "none",
}

# Run the Actor and wait for it to finish
run = client.actor("compass_lab/pinpointhq-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 '{
  "companies": [
    "field",
    "digitalscience"
  ],
  "includeDescription": false,
  "maxItems": 20,
  "maxPages": 3,
  "maxConcurrency": 2,
  "requestDelayMs": 1000,
  "proxyType": "none"
}' |
apify call compass_lab/pinpointhq-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,compass_lab/pinpointhq-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/dqWDxhfyGMrIEqSa3/builds/TIvOUY6f8Fjnq7VC1/openapi.json