# LinkedIn Jobs - Residential IPs (`exotic_integrity/linkedin-jobs-residential-ips`) Actor

Search LinkedIn's public guest jobs index through 23 real US residential IPs (Verizon AS701). BYOK against the MoneyMaker Residential Scraping API.

- **URL**: https://apify.com/exotic\_integrity/linkedin-jobs-residential-ips.md
- **Developed by:** [Kevin Yen](https://apify.com/exotic_integrity) (community)
- **Categories:** Developer tools, Automation, Jobs
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## LinkedIn Jobs - Residential IPs

Search LinkedIn's public guest jobs index from a real US residential IP
(Verizon AS701) and get back parsed job cards plus the raw HTML. Each request
rotates LRU through a 23-IP residential pool. Every dataset item includes the
literal egress IP so you can verify it yourself with `ipapi.com` or WHOIS.

This Actor is a thin wrapper around the **MoneyMaker Residential Scraping
API**'s `/v1/scrape/linkedin-jobs` endpoint. Apify hosts and runs the Actor;
the residential proxy fleet runs on Hetzner with Verizon AS701 ISP proxies.
Apify does **not** charge for this Actor — you bring your own API key from
the MoneyMaker listing on RapidAPI (or directly from the publisher).

---

### Why residential matters for LinkedIn

LinkedIn's public guest jobs index does aggressive ASN-level filtering at
the TCP layer before any HTML renders:

- Datacenter ranges (AWS, GCP, DigitalOcean, Azure) get a stripped guest
  skeleton, an HTTP 999 "Request denied", or a redirect to the auth wall.
- Residential ASNs (Verizon AS701, Comcast AS7922, Spectrum AS20115) get
  the full server-rendered job listing HTML with every card's title,
  company, location, posting timestamp, and stable job URL.

That's a structural difference, not a rate-limit difference. Pulling 1
result from a datacenter IP is harder than pulling 1,000 from residential.

---

### Use cases

- **ATS / CRM enrichment** — fetch company hiring signals on a candidate
  account; auto-tag accounts that posted Senior Backend roles in the last 7
  days.
- **Talent intelligence** — track competitor hiring velocity, location
  trends, role-mix shifts.
- **Recruiting automation** — feed an internal sourcing tool with fresh
  postings filtered by keyword / location / posting date.
- **Market research** — count "Senior Python Engineer" postings by metro
  monthly to model hiring demand.
- **Compensation benchmarking** — combine with Levels.fyi / Glassdoor data
  on the same role and location.

---

### Inputs

| Field         | Type            | Required | Description                                                      |
| ------------- | --------------- | -------- | ---------------------------------------------------------------- |
| `keywords`    | string          | yes      | Job-title or skills query, e.g. `Senior Python Engineer`         |
| `location`    | string          | no       | Geo string, e.g. `United States`, `San Francisco Bay Area`       |
| `count`       | integer (1-50)  | no       | How many job cards to return (default 25)                        |
| `start`       | integer         | no       | Pagination offset (default 0; use 25 for the next page)          |
| `apiKey`      | string (secret) | yes      | Your MoneyMaker API key (`mm_sk_...`)                            |
| `apiBaseUrl`  | string          | no       | Default: the public MM origin                                    |
| `verifyTls`   | boolean         | no       | Default true                                                     |

---

### Output

Two kinds of dataset items per run.

#### 1. The raw response (one per run)

```json
{
  "kind": "raw_response",
  "ok": true,
  "request_id": "req_w-v8wa1qZ79YcihQ",
  "status_code": 200,
  "ip_used": "65.195.39.208",
  "proxy_node": "Hetzner-12",
  "headers": { "content-type": "text/html; charset=UTF-8" },
  "body": "<!DOCTYPE html>...<li class=\"job-search-card\">...",
  "body_truncated": false,
  "upstream_latency_ms": 1820,
  "actor_latency_ms": 1900,
  "search": { "keywords": "Senior Python Engineer", "location": "United States", "count": 25, "start": 0 }
}
````

#### 2. One parsed job card per item

```json
{
  "kind": "job_card",
  "ok": true,
  "title": "Senior Python Engineer",
  "company": "Stripe",
  "location": "South San Francisco, CA",
  "posted_at": "2026-04-29",
  "job_url": "https://www.linkedin.com/jobs/view/senior-python-engineer-at-stripe-3987654321",
  "job_id": "3987654321",
  "ip_used": "65.195.39.208",
  "search": { "keywords": "Senior Python Engineer", "location": "United States", "count": 25, "start": 0 }
}
```

The Actor's key-value store also gets a `SUMMARY` record with the search
inputs, parsed-card count, the residential IP used, and timing.

***

### How it works

```
Apify run
    │
    ▼
Actor (this code)
    │   GET /v1/scrape/linkedin-jobs?keywords=...&location=...&count=...&start=...
    │   Authorization: Bearer <your MM key>
    ▼
MoneyMaker Scraping API
    │   Picks an LRU residential proxy from the 23-IP pool
    ▼
Verizon AS701 home-broadband IP
    │   GET https://www.linkedin.com/jobs/search/?keywords=...
    ▼
LinkedIn returns full job-listings HTML → JSON wrapper to Actor → push_data
```

You only pay MoneyMaker for the underlying calls — Apify is free. Costs
follow the MoneyMaker pricing tiers on RapidAPI.

***

### Pacing guidance

- One run is one upstream call. To page through deeper results, schedule
  multiple runs with `start = 0, 25, 50, 75, ...`.
- LinkedIn caps the public guest index at roughly 1,000 results per query;
  past that, set additional filters via `keywords` / `location`.
- Cache aggressively. A given keyword/location pair changes maybe a few
  times per hour — daily polling is plenty for most analytics use cases.
- Respect LinkedIn's ToS. This Actor only fetches the publicly accessible
  guest-mode HTML — no auth bypass, no scraping of authenticated views, no
  CAPTCHA solving.

***

### Limitations

- **Public guest data only.** No salary, no description body, no applicant
  count, no recruiter contact — those fields require an authenticated
  session and are out of scope.
- **No JS rendering.** Static HTML only.
- **US residential only.** All egress is Verizon AS701 / United States.
- **No CAPTCHA solving.** If LinkedIn returns a challenge, you'll see the
  challenge HTML — it's not auto-solved.
- **Body cap of 2 MB** per response.

***

### Source & support

The Actor source lives at
[`sksyen/moneymaker-dashboard/scripts/apify_actor_linkedin_jobs`](https://github.com/sksyen/moneymaker-dashboard).
Issues and feature requests go on the GitHub repo. Underlying API contract
is published as OpenAPI 3.0 at the `/openapi.yaml` path on the origin.

# Actor input Schema

## `keywords` (type: `string`):

Job-title or skills keywords, e.g. 'Senior Python Engineer' or 'staff data scientist'. Passed verbatim to LinkedIn's public guest jobs search.

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

Geo string accepted by LinkedIn, e.g. 'United States', 'San Francisco Bay Area', 'Remote', 'New York, NY'. Leave blank for worldwide.

## `count` (type: `integer`):

How many job cards to return per run. LinkedIn's guest index pages 25 results at a time; values >25 will internally page through start offsets.

## `start` (type: `integer`):

Zero-based result offset. Use 0 for the first page, 25 for the second, etc. Combined with `count` this lets you walk a full result set in batches.

## `apiKey` (type: `string`):

Your API key from the MoneyMaker Residential Scraping API (sign up via the listing on RapidAPI or contact for a direct key). Format: mm\_sk\_... — paste the bare token, not the Bearer header.

## `apiBaseUrl` (type: `string`):

Public endpoint of the Residential Scraping API. Provided by your API key issuer.

## `verifyTls` (type: `boolean`):

Disable only if pointing at a bare-IP origin without a valid cert. Default true.

## Actor input object example

```json
{
  "keywords": "Senior Python Engineer",
  "location": "United States",
  "count": 25,
  "start": 0,
  "apiBaseUrl": "https://api.example.com:8443",
  "verifyTls": true
}
```

# 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 = {
    "keywords": "Senior Python Engineer",
    "location": "United States"
};

// Run the Actor and wait for it to finish
const run = await client.actor("exotic_integrity/linkedin-jobs-residential-ips").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 = {
    "keywords": "Senior Python Engineer",
    "location": "United States",
}

# Run the Actor and wait for it to finish
run = client.actor("exotic_integrity/linkedin-jobs-residential-ips").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 '{
  "keywords": "Senior Python Engineer",
  "location": "United States"
}' |
apify call exotic_integrity/linkedin-jobs-residential-ips --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "LinkedIn Jobs - Residential IPs",
        "description": "Search LinkedIn's public guest jobs index through 23 real US residential IPs (Verizon AS701). BYOK against the MoneyMaker Residential Scraping API.",
        "version": "0.1",
        "x-build-id": "AmplG4mliDuSOjVmg"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/exotic_integrity~linkedin-jobs-residential-ips/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-exotic_integrity-linkedin-jobs-residential-ips",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/exotic_integrity~linkedin-jobs-residential-ips/runs": {
            "post": {
                "operationId": "runs-sync-exotic_integrity-linkedin-jobs-residential-ips",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/exotic_integrity~linkedin-jobs-residential-ips/run-sync": {
            "post": {
                "operationId": "run-sync-exotic_integrity-linkedin-jobs-residential-ips",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "keywords",
                    "apiKey"
                ],
                "properties": {
                    "keywords": {
                        "title": "Search keywords",
                        "type": "string",
                        "description": "Job-title or skills keywords, e.g. 'Senior Python Engineer' or 'staff data scientist'. Passed verbatim to LinkedIn's public guest jobs search."
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Geo string accepted by LinkedIn, e.g. 'United States', 'San Francisco Bay Area', 'Remote', 'New York, NY'. Leave blank for worldwide."
                    },
                    "count": {
                        "title": "Result count",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "How many job cards to return per run. LinkedIn's guest index pages 25 results at a time; values >25 will internally page through start offsets.",
                        "default": 25
                    },
                    "start": {
                        "title": "Pagination offset",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Zero-based result offset. Use 0 for the first page, 25 for the second, etc. Combined with `count` this lets you walk a full result set in batches.",
                        "default": 0
                    },
                    "apiKey": {
                        "title": "MoneyMaker API key",
                        "type": "string",
                        "description": "Your API key from the MoneyMaker Residential Scraping API (sign up via the listing on RapidAPI or contact for a direct key). Format: mm_sk_... — paste the bare token, not the Bearer header."
                    },
                    "apiBaseUrl": {
                        "title": "API base URL",
                        "type": "string",
                        "description": "Public endpoint of the Residential Scraping API. Provided by your API key issuer.",
                        "default": "https://api.example.com:8443"
                    },
                    "verifyTls": {
                        "title": "Verify TLS to upstream",
                        "type": "boolean",
                        "description": "Disable only if pointing at a bare-IP origin without a valid cert. Default true.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```