{ "openapi": "3.0.1", "info": { "title": "Preply Tutor Profiles Scraper", "description": "Scrape Preply tutor profiles, search tutors by language, subject, price, and rating. Get name, country, hourly rate, rating, reviews, lessons count, bio, avatar, and more. Supports bulk tutor lookups by URL or ID.", "version": "1.0", "x-build-id": "x0KRhBesXIjL9q3kf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~preply-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-preply-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~preply-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-preply-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~preply-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-preply-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": [ "searchTutors", "getTutor" ], "type": "string", "description": "What to fetch: search tutors by language/filters, or retrieve specific tutor profiles by URL or ID.", "default": "searchTutors" }, "language": { "title": "Language", "enum": [ "english", "spanish", "french", "german", "italian", "portuguese", "chinese", "japanese", "korean", "russian", "arabic", "dutch", "polish", "turkish", "swedish", "norwegian", "danish", "finnish", "hebrew", "hindi", "ukrainian", "greek", "romanian", "czech", "hungarian", "catalan", "thai", "vietnamese", "indonesian", "malay", "persian", "tagalog", "urdu", "bengali", "swahili" ], "type": "string", "description": "Language to search tutors for (mode=searchTutors).", "default": "spanish" }, "startUrls": { "title": "Tutor URLs (mode=getTutor)", "type": "array", "description": "List of Preply tutor profile URLs (e.g. https://preply.com/en/tutor/12345). Used in mode=getTutor.", "default": [], "items": { "type": "string" } }, "tutorIds": { "title": "Tutor IDs (mode=getTutor)", "type": "array", "description": "List of Preply tutor numeric IDs. Used in mode=getTutor.", "default": [], "items": { "type": "string" } }, "subject": { "title": "Subject / Specialty", "type": "string", "description": "Optional subject or specialty to filter tutors (e.g. 'Business English', 'IELTS', 'Conversation')." }, "sortBy": { "title": "Sort By", "enum": [ "popularity", "rating", "reviews", "price_lowest", "price_highest" ], "type": "string", "description": "How to order search results.", "default": "popularity" }, "minPrice": { "title": "Min hourly price (USD)", "minimum": 0, "maximum": 1000, "type": "number", "description": "Only return tutors with hourly rate at or above this value." }, "maxPrice": { "title": "Max hourly price (USD)", "minimum": 0, "maximum": 1000, "type": "number", "description": "Only return tutors with hourly rate at or below this value." }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only return tutors with average rating at or above this value (0–5)." }, "nativeOnly": { "title": "Native speakers only", "type": "boolean", "description": "If true, only return tutors who are native speakers of the selected language.", "default": false }, "proOnly": { "title": "Professional tutors only", "type": "boolean", "description": "If true, only return certified/professional tutors.", "default": false }, "tutorCountry": { "title": "Tutor country filter", "type": "string", "description": "Optional comma-separated ISO country codes to filter tutors by their country (e.g. 'US', 'GB,US,CA')." }, "availabilityDay": { "title": "Availability day", "enum": [ "", "sun", "mon", "tue", "wed", "thu", "fri", "sat" ], "type": "string", "description": "Filter tutors available on a specific weekday.", "default": "" }, "useProxy": { "title": "Use residential proxy", "type": "boolean", "description": "Use Apify residential proxy to bypass Cloudflare protection. Recommended.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of tutor 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 } } } } } } } } } }