# PracticeLink Job Scraper (`shahidirfan/practicelink-job-scraper`) Actor

Rapidly extract physician and healthcare job listings from PracticeLink. Designed for ultra-fast performance without external dependencies. Get detailed medical job data instantly for recruitment or analysis. The ultimate tool for healthcare job aggregation!

- **URL**: https://apify.com/shahidirfan/practicelink-job-scraper.md
- **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community)
- **Categories:** Jobs, Developer tools, Automation
- **Stats:** 11 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

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

## PracticeLink Job Scraper

Extract comprehensive physician and healthcare job listings from PracticeLink with complete data including specialties, locations, salaries, and full job descriptions. Collect thousands of medical career opportunities at scale with automated data extraction. Perfect for healthcare recruiters, market research, and job board aggregation.

### Features

- **Specialty-based search** — Filter by 50+ medical specialties including Family Medicine, Cardiology, Emergency Medicine, Anesthesiology, and more
- **Geographic filtering** — Search by U.S. state, city, or nationwide for location-based job opportunities
- **Comprehensive job details** — Automatically extracts titles, companies, specialties, salaries, posting dates, and visa sponsorship indicators
- **Reliable structured collection** — Captures consistent, high-quality records at scale with strong duplicate handling
- **Advanced scraping** — Handles pagination seamlessly to collect all matching healthcare job opportunities
- **Data richness** — Returns 30+ fields per job including employer contact info, facility details, and benefits information

### Use Cases

#### Healthcare Recruitment

Build comprehensive physician talent pipelines and candidate matching systems. Extract vacancy data across specialties, locations, and facility types to connect healthcare professionals with ideal opportunities.

#### Job Board Aggregation

Power multi-source healthcare career platforms by integrating fresh, high-quality job listings from PracticeLink into your platform. Ensure your users access the latest medical employment opportunities.

#### Market Intelligence & Analytics

Analyze healthcare employment trends, track specialty demand across regions, monitor salary ranges, and identify geographic hiring hotspots. Build data-driven insights about the physician job market.

#### Competitive Analysis

Monitor competitor hiring activities, benchmark compensation packages across healthcare organizations, and identify market expansion opportunities with competitive intelligence.

#### Academic Research

Study healthcare workforce distribution patterns, analyze specialty availability by region, and research employment trends in medical fields for academic publications and reports.

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `specialty` | String | No | Family Medicine | Medical specialty to search (e.g., "Cardiology", "Emergency Medicine", "Anesthesiology") |
| `state` | String | No | California | U.S. state filter (e.g., "Texas", "New York"). Leave empty for all states |
| `city` | String | No | — | Specific city to narrow results. Works with state filter |
| `jobType` | String | No | — | Employment type filter (e.g., "Full-Time", "Part-Time", "Locum Tenens") |
| `startUrl` | String | No | — | Direct PracticeLink search URL. Overrides specialty/state/city filters if provided |
| `results_wanted` | Integer | No | 20 | Maximum number of jobs to extract. Lower values complete faster |
| `max_pages` | Integer | No | 5 | Maximum search result pages to process. Controls pagination depth |

### Output Data

Each extracted job contains comprehensive fields:

| Field | Type | Description |
|-------|------|-------------|
| `title` | String | Job position title or role name |
| `company` | String | Healthcare organization or employer name |
| `specialty` | String | Medical specialty or practice area |
| `location` | String | Job location (City, State format) |
| `salary` | String | Compensation information (e.g., "$200,000 - $250,000") |
| `job_type` | String | Employment type (Full-Time, Part-Time, Locum Tenens, etc.) |
| `date_posted` | String | Posting verification date when available |
| `url` | String | Direct link to the job listing on PracticeLink |
| `employer_id` | Number | Unique PracticeLink employer identifier |
| `facility_name` | String | Healthcare facility name |
| `immigration_assistance` | Boolean | Indicates immigration support availability |
| `accepts_j1_visas` | Boolean | Indicates J1 visa support |
| `accepts_h1b_visas` | Boolean | Indicates H1B visa support |
| `practice_type` | String | Practice type classification |
| `salary_period` | String | Compensation period (for example, annual) |
| `member_contact_name` | String | Recruiter or contact name when available |

### Usage Examples

#### Basic Specialty Search

Extract 20 Family Medicine positions in California:

```json
{
  "specialty": "Family Medicine",
  "state": "California",
  "results_wanted": 20,
  "max_pages": 5
}
```

#### Advanced Multi-Filter Search

Target specific job type and location combination:

```json
{
  "specialty": "Emergency Medicine",
  "state": "Texas",
  "city": "Houston",
  "jobType": "Full-Time",
  "results_wanted": 50,
  "max_pages": 10
}
```

#### Custom URL Search

Use a specific PracticeLink search URL for advanced filtering:

```json
{
  "startUrl": "https://jobs.practicelink.com/jobboard/jobsearchresults?specialty=Cardiology&state=Florida",
  "results_wanted": 100,
  "max_pages": 20
}
```

### Sample Output

```json
{
  "title": "Emergency Medicine Physician",
  "company": "SCP Health",
  "specialty": "Emergency Medicine",
  "location": "Alice, TX",
  "salary": "315,000 - 410,000 / Yearly",
  "job_type": "FULL_TIME",
  "date_posted": "02/16/2026",
  "url": "https://jobs.practicelink.com/jobs/1542998/emergency-medicine/physician/texas/alice",
  "job_id": 1542998,
  "employer_id": 830,
  "facility_name": "SCP Health",
  "immigration_assistance": false,
  "accepts_j1_visas": true,
  "accepts_h1b_visas": true,
  "salary_period": "Yearly",
  "member_contact_name": "Recruiting Team",
  "search_specialty": "Family Medicine",
  "search_state": "California"
}
```

### Tips for Best Results

#### Choose Exact Specialty Names

Use precise specialty names exactly as they appear on PracticeLink (e.g., "Cardiology" instead of "Heart Doctor"). This ensures accurate filtering and best match results.

#### Combine Filters Strategically

Use state + specialty combinations to narrow results to your target market. Add city filters for ultra-specific location targeting in high-demand areas.

#### Extended Metadata Included By Default

The scraper always includes extended fields such as visa indicators, compensation components, contact fields, and employer metadata.

#### Optimize Collection Size

Start with `results_wanted: 20-30` for testing. Increase to 50-100+ for production runs. Higher numbers take longer but capture more opportunities.

#### Monitor Costs

Use reasonable `max_pages` limits (5-10) in combination with lower `results_wanted` values to control Apify compute unit consumption while gathering sufficient data.

#### Keep Output Clean

Records are deduplicated by job ID and empty fields are omitted automatically. This keeps exports cleaner for analytics and downstream integrations.

#### Use Default Proxy Settings

Residential proxies are enabled by default. This ensures reliable, uninterrupted extraction even if PracticeLink detects and blocks datacenter IPs.

### Frequently Asked Questions

#### How fresh is the data?

PracticeLink updates listings continuously. Run the scraper regularly (daily or weekly) to capture new postings and job changes.

#### Can I search multiple specialties at once?

Currently, the scraper processes one specialty per run for optimal performance. For multiple specialties, run separate extractions or use custom search URLs combining parameters.

#### What if extraction fails on some jobs?

The scraper includes automatic retry logic and error handling. Failed pages are logged but don't interrupt the overall extraction process.

#### How accurate is the extracted data?

The scraper extracts data exactly as it appears on PracticeLink. Accuracy depends on the completeness and accuracy of source listings.

#### Can I export to CSV or Excel?

Yes, the Apify platform allows exporting results to CSV, Excel, JSON, XML, and other formats directly from the dataset.

#### What's the estimated runtime?

With default settings (20 results, 5 pages), typical runs complete in 60-120 seconds depending on network speed and Apify system load.

### Legal & Compliance

This scraper extracts publicly available job listing data from PracticeLink. Users must:

- Comply with PracticeLink's [Terms of Service](https://www.practicelink.com)
- Follow applicable data protection regulations (GDPR, CCPA, etc.)
- Use extracted data ethically for legitimate business purposes
- Respect employment and recruitment laws in your jurisdiction
- Review and comply with PracticeLink's [robots.txt](https://jobs.practicelink.com/robots.txt) file

### Support

For questions or issues:

- Review the [Apify documentation](https://docs.apify.com)
- Check the [input schema](./.actor/input_schema.json) for parameter details
- Monitor actor run logs for debugging information
- Verify job URLs are accessible before running at scale

***

**Need more data sources?** Explore additional healthcare and medical job scrapers in the [Apify Store](https://apify.com/store).

# Actor input Schema

## `startUrl` (type: `string`):

Start scraping from a specific PracticeLink search URL. If provided, this will override specialty/state/city filters.

## `specialty` (type: `string`):

Medical specialty to search for (e.g., 'Family Medicine', 'Cardiology', 'Emergency Medicine', 'Anesthesiology').

## `state` (type: `string`):

U.S. state to filter jobs (e.g., 'California', 'Texas', 'New York'). Leave empty for all states.

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

Specific city to filter jobs. Works in combination with state filter.

## `jobType` (type: `string`):

Employment type filter (e.g., 'Full-Time', 'Part-Time', 'Locum Tenens').

## `results_wanted` (type: `integer`):

Maximum number of job listings to collect. Set a reasonable limit to control scraping time and cost.

## `max_pages` (type: `integer`):

Safety limit on the number of search result pages to scrape.

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

Proxy settings for reliable scraping. Residential proxies recommended for best results.

## Actor input object example

```json
{
  "startUrl": "https://jobs.practicelink.com/jobboard/jobsearchresults?specialty=Family+Medicine&state=California&jobtype=Full-Time",
  "specialty": "Family Medicine",
  "state": "California",
  "results_wanted": 20,
  "max_pages": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrl": "https://jobs.practicelink.com/jobboard/jobsearchresults?specialty=Family+Medicine&state=California&jobtype=Full-Time",
    "specialty": "Family Medicine",
    "state": "California",
    "results_wanted": 20,
    "max_pages": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("shahidirfan/practicelink-job-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 = {
    "startUrl": "https://jobs.practicelink.com/jobboard/jobsearchresults?specialty=Family+Medicine&state=California&jobtype=Full-Time",
    "specialty": "Family Medicine",
    "state": "California",
    "results_wanted": 20,
    "max_pages": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("shahidirfan/practicelink-job-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 '{
  "startUrl": "https://jobs.practicelink.com/jobboard/jobsearchresults?specialty=Family+Medicine&state=California&jobtype=Full-Time",
  "specialty": "Family Medicine",
  "state": "California",
  "results_wanted": 20,
  "max_pages": 5
}' |
apify call shahidirfan/practicelink-job-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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