{ "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 } } } } } } } } } }