PracticeLink Scraper

Scrape PracticeLink — the leading US physician-recruitment job board with 27K+ active physician, NP/PA and healthcare jobs. Search by keyword, location, state and specialty, or fetch full job details (employer, description, education requirements, visa commitments, direct-apply status) by job ID or URL. HTTP-only via the public jobs.practicelink.com site. No auth, no proxy.

What this actor does

• Three modes: search, byId, byUrl
• Rich filters: keyword, location, state, specialty, profession, practice type, employment type, recruitment type, loan assistance, immigration assistance, telemedicine, sort order
• Search cards: facility, parent organization, location, specialty, employment type, recruitment type
• Full detail records: JSON-LD structured data with employer, address, education requirements, visa commitments
• Empty fields are omitted

Output per job (mode = search)

• jobId, title
• facility, parentOrganization, location (e.g. Page, AZ)
• categories[], specialty, employmentType
• recruitmentType — Employer Direct, Recruiter or Search Firm
• url, sourceUrl

Output per job (mode = byId / byUrl)

• jobId, title
• description — full job description (HTML stripped to text)
• datePosted, validThrough
• employmentType (FULL_TIME / PART_TIME / ...), employmentTypePage
• telemedicine — true/false when the page states it
• city, state, postalCode, country
• hiringOrganization, hiringOrganizationUrl, hiringOrgLogoUrl
• educationRequirements[], occupationalCategory
• specialCommitments — e.g. Accepts U.S. J1 & H1B Visas
• directApply — whether the employer accepts direct applications
• industry[], postedBy
• practicelinkUrl, sourceUrl, recordType: "job", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byId / byUrl
searchQuery	string	family medicine	Free-text keyword (mode=search)
location	string	–	City/region, e.g. Chicago, Texas (mode=search)
state	enum	–	US state/territory (e.g. TX)
specialty	enum	–	Full 204-value specialty taxonomy (e.g. Family Medicine, Hospitalist)
sortBy	enum	relevance	relevance / verified_date_asc / verified_date_desc
employmentType	enum	–	Not Specified / Full-Time / Part-Time / Contract / Internship / Temporary / Locum Tenens / Other / Seasonal
recruitmentType	enum	–	Employer Direct / Recruiter / Search Firm
profession	enum	–	Full profession taxonomy (e.g. Physician, CRNA, Nurse Practitioner)
practiceType	enum	–	Practice setting (e.g. Group Practice, Hospital Employee, Locum Tenens)
loanAssistance	enum	–	Yes / No / Negotiable
immigrationAssistance	enum	–	Visa support (e.g. Accepts U.S. J1 & H1B Visas)
telemedicine	enum	–	Yes / No
jobIds	array	–	Job IDs (mode=byId)
startUrls	array	–	Job detail URLs (mode=byUrl)
postedWithinDays	int	–	Only jobs posted within N days (detail records)
containsKeyword	string	–	Substring filter on title/organization/city/state
maxItems	int	50	Hard cap (1–1000)

Example: family medicine jobs in Texas

{
  "mode": "search",
  "searchQuery": "family medicine",
  "location": "Texas",
  "maxItems": 50
}

Example: hospitalist jobs in a state, newest first

{
  "mode": "search",
  "specialty": "Hospitalist",
  "state": "TX",
  "sortBy": "verified_date_desc",
  "maxItems": 100
}

Example: full details for specific jobs

{
  "mode": "byId",
  "jobIds": ["1481516", "1597926"]
}

Example: lookup by URL

{
  "mode": "byUrl",
  "startUrls": [
    {"url": "https://jobs.practicelink.com/jobs/1481516/urgent-care/nurse-practitioner/illinois/ocuc-bradford/"}
  ]
}

Use cases

• Physician recruiters — monitor competitor postings by specialty, state and facility
• Healthcare staffing — pipeline of open NP/PA and physician roles with direct-apply status
• Job seekers — track verified-date-sorted postings in target states and specialties
• Provider compensation research — collect specialCommitments, requirements and employment types
• Hospital systems — benchmark recruiting mix (Employer Direct vs agency)

FAQ

What is PracticeLink? A US physician-recruitment job board listing 27K+ active jobs across all 50 states, covering physicians, NPs, PAs and allied healthcare roles.

Are there rate limits? No documented hard cap. The actor uses small polite delays and retries on 429/5xx.

What is recruitmentType? Whether the job was posted directly by the employer (Employer Direct), by a recruiter (Recruiter) or by a search firm/agency (Search Firm).

What does specialCommitments mean? PracticeLink's shorthand for visa support — e.g. Accepts U.S. J1 & H1B Visas.

Why do search-mode records have fewer fields than detail records? Search results are listing cards; the rich fields (description, employer, requirements) live on the detail page. Use byId/byUrl (or containsKeyword + a follow-up pass) for full records.

How fresh is the data? Live — every run queries PracticeLink in real time.

Is this affiliated with PracticeLink? No. This is an independent third-party actor using the public website.