# italki Tutor Profiles & Languages Scraper (`crawlerbros/italki-scraper`) Actor Scrape italki teacher profiles with search professional teachers and community tutors by language, price, rating, and lesson count. Get name, country, teacher type, hourly rate, lessons count, students count, rating, reviews, bio, avatar, and more. - **URL**: https://apify.com/crawlerbros/italki-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 7 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## italki Tutor Profiles & Languages Scraper Extract comprehensive teacher profiles from [italki](https://www.italki.com) — the world's largest online language learning community with 10,000+ professional teachers and community tutors across 150+ languages. Search by language, teacher type, price, rating, and lesson count. Ideal for market research, education analytics, and competitive intelligence. ### What You Get Each teacher profile includes: | Field | Description | |---|---| | `teacherId` | Unique italki teacher identifier | | `name` | Teacher's display name | | `country` | Teacher's country of origin | | `teacherType` | `"Professional Teacher"` or `"Community Tutor"` | | `languagesTaught` | Languages this teacher teaches | | `nativeLanguages` | Teacher's native language(s) | | `hourlyRate` | Price per hour in USD | | `currency` | Pricing currency | | `lessonsCount` | Total lessons completed on italki | | `studentsCount` | Total number of students | | `rating` | Average student rating (0–5) | | `reviewCount` | Total student reviews | | `bio` | Teacher's introduction/description | | `profileUrl` | Direct link to teacher's italki profile | | `avatarUrl` | Profile photo URL | | `videoUrl` | Introduction video URL | | `hasGroupClasses` | Whether the teacher offers group classes | | `recordType` | Always `"teacher"` | | `scrapedAt` | ISO 8601 timestamp of extraction | ### Teacher Types italki has two types of teachers: - **Professional Teacher** — Certified language teachers with formal teaching credentials and structured lesson plans - **Community Tutor** — Native or fluent speakers who offer informal conversation practice at lower rates ### Modes #### `searchTeachers` (default) Search for teachers by language with optional filters. Returns results sorted by your chosen criteria. **Example input:** ```json { "mode": "searchTeachers", "language": "japanese", "teacherType": "professional_teacher", "minRating": 4.5, "maxItems": 50 } ```` #### `byLanguage` Retrieve all available teachers for a specific language, paginating through the complete listing. **Example input:** ```json { "mode": "byLanguage", "language": "korean", "maxItems": 200 } ``` #### `getTeacher` Fetch full profiles for specific teachers by their italki profile URL or numeric ID. **Example input:** ```json { "mode": "getTeacher", "startUrls": [ "https://www.italki.com/en/teacher/123456", "https://www.italki.com/en/teacher/654321" ] } ``` ### Input Reference | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `searchTeachers` | Operation mode | | `language` | select | `japanese` | Language to search teachers for | | `startUrls` | array | — | Teacher profile URLs (mode=getTeacher) | | `teacherIds` | array | — | Numeric teacher IDs (mode=getTeacher) | | `teacherType` | select | All types | Filter by teacher type | | `sortBy` | select | `recommended` | `recommended` / `price_asc` / `price_desc` / `rating` / `lessons` | | `minPrice` | number | — | Minimum hourly rate (USD) | | `maxPrice` | number | — | Maximum hourly rate (USD) | | `minRating` | number | — | Minimum average rating (0–5) | | `minLessons` | integer | — | Minimum completed lessons count | | `useResidentialProxy` | boolean | `true` | Required — italki blocks datacenter IPs | | `maxItems` | integer | `20` | Maximum profiles to return (1–5000) | ### Supported Languages English, Spanish, French, German, Japanese, Chinese (Mandarin), Korean, Italian, Portuguese, Russian, Arabic, Dutch, Polish, Turkish, Swedish, Norwegian, Hindi, Hebrew, Greek, Vietnamese, Thai, Indonesian, Malay, Filipino (Tagalog), Ukrainian, Romanian, Czech, Hungarian, Danish, Finnish, Persian (Farsi), Bengali, Urdu, Swahili, Catalan, and more. ### Output Example ```json { "teacherId": "123456", "name": "Yuki Tanaka", "country": "Japan", "teacherType": "Professional Teacher", "languagesTaught": ["Japanese"], "nativeLanguages": ["Japanese"], "hourlyRate": 20.0, "currency": "USD", "lessonsCount": 850, "studentsCount": 120, "rating": 4.8, "reviewCount": 95, "bio": "Native Japanese teacher with 5 years experience...", "profileUrl": "https://www.italki.com/en/teacher/123456", "avatarUrl": "https://static.italki.com/avatar/123456.jpg", "hasGroupClasses": true, "recordType": "teacher", "scrapedAt": "2026-05-17T10:00:00+00:00" } ``` ### Use Cases - **Market Research** — Compare teacher pricing, ratings, and specializations across languages - **Competitive Analysis** — Benchmark italki's teacher supply against other platforms - **Education Analytics** — Study teacher demographics, lesson counts, and student demand by language - **Language Learning Research** — Identify top-rated teachers and in-demand languages - **Platform Intelligence** — Track italki teacher growth and availability trends ### About Residential Proxy italki uses **Cloudflare Bot Management** (confirmed in a published Cloudflare case study). Datacenter IP addresses are blocked. **Residential proxy is required** for reliable scraping. The actor uses Apify's residential proxy network by default. Leave `useResidentialProxy` enabled for best results. ### Performance - Processes **20 teachers per page** via italki's internal API - Supports up to **5,000 teachers** per run - Uses TLS fingerprint spoofing (curl\_cffi) with automatic Playwright fallback - **Session rotation** for resilience against rate limiting - Retry logic on server errors (5xx) and rate limits (429) ### FAQ **Q: Does this require an italki account?** A: No. The actor uses italki's public teacher directory — no login or API key required. **Q: Why is residential proxy required?** A: italki specifically uses Cloudflare Bot Management to block automated access from datacenter IP ranges. Residential proxies route traffic through real user IP addresses that bypass this protection. **Q: What's the difference between Professional Teacher and Community Tutor?** A: Professional Teachers have formal teaching credentials and typically charge higher rates with structured lessons. Community Tutors are native/fluent speakers who offer informal conversational practice at lower cost. **Q: Can I scrape a specific language's full teacher list?** A: Yes — use `mode=byLanguage` with a high `maxItems` value to paginate through the complete teacher listing for any language. **Q: How accurate is the data?** A: Each run fetches live data directly from italki at execution time. Ratings, prices, and lesson counts reflect real-time platform data. **Q: How many teachers can I scrape per run?** A: Up to 5,000 per run. For larger datasets, run multiple times with different filter criteria. **Q: Does italki offer group classes?** A: Some teachers offer group classes in addition to 1-on-1 lessons. The `hasGroupClasses` field indicates this availability. # Actor input Schema ## `mode` (type: `string`): What to fetch: search teachers by language/filters, get all teachers for a language, or retrieve specific teacher profiles. ## `language` (type: `string`): Language to search teachers for. ## `startUrls` (type: `array`): List of italki teacher profile URLs (e.g. https://www.italki.com/en/teacher/123456). Used in mode=getTeacher. ## `teacherIds` (type: `array`): List of italki teacher numeric IDs. Used in mode=getTeacher. ## `teacherType` (type: `string`): Filter by teacher type. Leave empty to return all types. ## `sortBy` (type: `string`): How to order search results. ## `minPrice` (type: `number`): Only return teachers with hourly rate at or above this value. ## `maxPrice` (type: `number`): Only return teachers with hourly rate at or below this value. ## `minRating` (type: `number`): Only return teachers with average rating at or above this value (0–5). ## `minLessons` (type: `integer`): Only return teachers who have completed at least this many lessons. ## `useResidentialProxy` (type: `boolean`): Use Apify residential proxy. italki uses Cloudflare Bot Management that blocks datacenter IPs — residential proxy is required for reliable scraping. ## `maxItems` (type: `integer`): Maximum number of teacher profiles to return. ## Actor input object example ```json { "mode": "searchTeachers", "language": "japanese", "startUrls": [], "teacherIds": [], "teacherType": "", "sortBy": "recommended", "useResidentialProxy": true, "maxItems": 20 } ``` # Actor output Schema ## `teachers` (type: `string`): Dataset containing all scraped italki teacher profiles. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "searchTeachers", "language": "japanese", "startUrls": [], "teacherIds": [], "teacherType": "", "sortBy": "recommended", "useResidentialProxy": true, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/italki-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "searchTeachers", "language": "japanese", "startUrls": [], "teacherIds": [], "teacherType": "", "sortBy": "recommended", "useResidentialProxy": True, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/italki-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 '{ "mode": "searchTeachers", "language": "japanese", "startUrls": [], "teacherIds": [], "teacherType": "", "sortBy": "recommended", "useResidentialProxy": true, "maxItems": 20 }' | apify call crawlerbros/italki-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/italki-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "italki Tutor Profiles & Languages Scraper", "description": "Scrape italki teacher profiles with search professional teachers and community tutors by language, price, rating, and lesson count. Get name, country, teacher type, hourly rate, lessons count, students count, rating, reviews, bio, avatar, and more.", "version": "1.0", "x-build-id": "2xLak4nAaSijl94xQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~italki-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-italki-scraper", "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/crawlerbros~italki-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-italki-scraper", "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/crawlerbros~italki-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-italki-scraper", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchTeachers", "byLanguage", "getTeacher" ], "type": "string", "description": "What to fetch: search teachers by language/filters, get all teachers for a language, or retrieve specific teacher profiles.", "default": "searchTeachers" }, "language": { "title": "Language", "enum": [ "english", "spanish", "french", "german", "japanese", "chinese", "korean", "italian", "portuguese", "russian", "arabic", "dutch", "polish", "turkish", "swedish", "norwegian", "hindi", "hebrew", "greek", "vietnamese", "thai", "indonesian", "malay", "filipino", "ukrainian", "romanian", "czech", "hungarian", "danish", "finnish", "persian", "bengali", "urdu", "swahili", "catalan" ], "type": "string", "description": "Language to search teachers for.", "default": "japanese" }, "startUrls": { "title": "Teacher URLs (mode=getTeacher)", "type": "array", "description": "List of italki teacher profile URLs (e.g. https://www.italki.com/en/teacher/123456). Used in mode=getTeacher.", "default": [], "items": { "type": "string" } }, "teacherIds": { "title": "Teacher IDs (mode=getTeacher)", "type": "array", "description": "List of italki teacher numeric IDs. Used in mode=getTeacher.", "default": [], "items": { "type": "string" } }, "teacherType": { "title": "Teacher type", "enum": [ "", "teacher", "community_tutor", "professional_teacher" ], "type": "string", "description": "Filter by teacher type. Leave empty to return all types.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "recommended", "price_asc", "price_desc", "rating", "lessons" ], "type": "string", "description": "How to order search results.", "default": "recommended" }, "minPrice": { "title": "Min hourly price (USD)", "minimum": 0, "maximum": 200, "type": "number", "description": "Only return teachers with hourly rate at or above this value." }, "maxPrice": { "title": "Max hourly price (USD)", "minimum": 0, "maximum": 200, "type": "number", "description": "Only return teachers with hourly rate at or below this value." }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only return teachers with average rating at or above this value (0–5)." }, "minLessons": { "title": "Min lessons count", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only return teachers who have completed at least this many lessons." }, "useResidentialProxy": { "title": "Use residential proxy (required)", "type": "boolean", "description": "Use Apify residential proxy. italki uses Cloudflare Bot Management that blocks datacenter IPs — residential proxy is required for reliable scraping.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of teacher profiles to return.", "default": 20 } } }, "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 } } } } } } } } } } ```