TeacherOn Tutors Scraper

Extract tutor profiles from TeacherOn.com — a global tutoring marketplace with 200,000+ active tutors across 18,000+ subjects in 178 countries.

Use this actor to build datasets of tutors by subject, compare rates, analyze the tutoring market, or find qualified tutors for any subject area.

---

What This Actor Does

• Search tutors by keyword or subject query (e.g., "python", "math", "guitar")
• Browse by subject category using TeacherOn's subject slugs (e.g., python, web_scraping)
• Enrich specific profiles from a list of tutor profile URLs
• Filter results by minimum rating and minimum review count
• Filter by teaching type: online only, home/in-person only, or all types

---

Output Fields

Each record in the dataset represents one tutor:

Field	Type	Description
tutorId	string	Unique TeacherOn tutor identifier (e.g., 9ye0)
name	string	Tutor's display name
profileUrl	string	Full URL to the tutor's profile page
subjects	array of strings	All subjects the tutor teaches
teachingType	string	"online", "in-person", or "both"
hourlyRateMin	number	Minimum hourly rate in USD
hourlyRateMax	number	Maximum hourly rate in USD
currency	string	Always "USD"
avgRating	number	Average rating out of 5 (absent if no reviews)
reviewCount	integer	Number of student reviews
location	string	Tutor's location (city, state, country)
country	string	Country extracted from location
languages	array of strings	Languages the tutor speaks
verified	boolean	Whether the tutor has a verified green check
profilePhotoUrl	string	URL to the tutor's profile photo (if available)
bio	string	Tutor's self-description
recordType	string	Always "tutor"
scrapedAt	string	ISO 8601 UTC timestamp of scraping

---

Input Configuration

Mode

Mode	Description
searchTutors (default)	Search by keyword/subject query
bySubject	Browse by exact subject slug
byTutorUrls	Enrich a list of specific profile URLs

All Input Fields

Field	Type	Default	Description
mode	select	searchTutors	How to find tutors
searchQuery	string	—	Keyword or subject to search (e.g., python, guitar, english)
subjectSlug	string	—	Subject slug for bySubject mode (e.g., web_scraping, data_science)
tutorUrls	array	—	Profile URLs for byTutorUrls mode
teachingType	select	online	Filter: online, home, or both
minRating	number	—	Only emit tutors with rating ≥ this value (0–5)
minReviews	integer	—	Only emit tutors with ≥ this many reviews
maxItems	integer	20	Maximum number of tutor records to emit (1–5000)
useResidentialProxy	boolean	false	Enable residential proxy if datacenter IPs are blocked

---

Example Inputs

Search for Python tutors (online only, top 20)

{
  "mode": "searchTutors",
  "searchQuery": "python",
  "teachingType": "online",
  "maxItems": 20
}

Browse all data science tutors with at least 5 reviews

{
  "mode": "bySubject",
  "subjectSlug": "data_science",
  "minReviews": 5,
  "maxItems": 50
}

Enrich specific tutor profiles

{
  "mode": "byTutorUrls",
  "tutorUrls": [
    "https://www.teacheron.com/tutor/9ye0",
    "https://www.teacheron.com/tutor/2xTY"
  ]
}

Find highly-rated math tutors (4.5+ stars, 10+ reviews)

{
  "mode": "searchTutors",
  "searchQuery": "mathematics",
  "teachingType": "online",
  "minRating": 4.5,
  "minReviews": 10,
  "maxItems": 100
}

---

Subject Slug Reference

TeacherOn uses URL-safe slugs for subjects. Common examples:

Subject	Slug
Python	python
Web Scraping	web_scraping
Data Science	data_science
Machine Learning	machine_learning
Mathematics	mathematics
English	english
Guitar	guitar
JavaScript	javascript
SQL	sql
Excel	excel

To find the slug for any subject, visit https://www.teacheron.com/{subject}-tutors and use the URL path segment before -tutors.

---

Performance & Pricing

• Each tutor requires one profile page fetch for full data.
• Expect ~1–2 tutors per second at default settings.
• For 100 tutors, expect 2–4 minutes of run time.
• Memory: 2048 MB (Playwright).

---

Proxy & Anti-Bot

TeacherOn returns 403 from some datacenter IP ranges. The actor uses an escalating strategy:

1. Fast HTTP request (no cost)
2. Playwright headless browser (standard)
3. Enable useResidentialProxy if still blocked

Residential proxy adds cost per GB of data transferred. Try without it first.

---

Frequently Asked Questions

Q: What subjects can I search for? A: TeacherOn has 18,000+ subjects. Any skill or academic subject is likely available — from mathematics to guitar to Python programming.

Q: Can I get tutors for a specific country? A: Use mode=bySubject with the subject slug and filter by country in your downstream processing. The location and country fields are scraped from each profile.

Q: Why are some tutors missing a photo or rating? A: TeacherOn tutors don't have to upload a photo, and rating/review count only appears once a tutor has received at least one review. The actor only outputs fields that are present.

Q: What is the maximum number of tutors I can scrape? A: Up to 5,000 per run. TeacherOn listing pages show ~15 tutors per page.

Q: Can I filter for verified tutors only? A: The verified field is included in output. You can filter downstream using the Apify dataset API or integrate into your workflow.

Q: What does "teaching type" mean? A: TeacherOn tutors specify whether they teach online (video call), at the student's home (in-person), or both. The teachingType field reflects this.

Q: How fresh is the data? A: Data is scraped live from TeacherOn at run time. Each record includes a scrapedAt timestamp.

Q: Is this actor legal to use? A: This actor scrapes publicly available tutor profiles. Always review TeacherOn's terms of service and ensure your use case complies with applicable data protection regulations (GDPR, CCPA, etc.).