{ "openapi": "3.0.1", "info": { "title": "Preply Tutor Scraper", "description": "Extract tutor profiles, prices, ratings, and availability data from Preply.com. Filter by subject, country, native speaker status, availability, and more. Perfect for market research, competitor analysis, and lead generation in online tutoring.", "version": "1.0", "x-build-id": "oTQls9blwDE8iXGzx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~preply-tutor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-preply-tutor-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/epicscrapers~preply-tutor-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-preply-tutor-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/epicscrapers~preply-tutor-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-preply-tutor-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": [ "subject" ], "properties": { "subject": { "title": "Subject", "type": "string", "description": "The subject to search for (e.g., 'english', 'spanish', 'french', 'german', 'math'). Uses the subject alias as seen in Preply URLs.", "default": "english" }, "city": { "title": "City", "type": "string", "description": "Filter tutors by city. Use 'online' for all online tutors.", "default": "online" }, "maxPages": { "title": "Max Pages", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of result pages to scrape (1 page = ~20 tutors). Set to 0 for unlimited (scrapes all available).", "default": 5 }, "maxTutors": { "title": "Max Tutors", "minimum": 0, "type": "integer", "description": "Maximum number of tutor profiles to scrape. Set to 0 for unlimited.", "default": 0 }, "sort": { "title": "Sort Order", "enum": [ "", "POPULAR", "PRICE_ASC", "PRICE_DESC", "NEWEST", "RATING", "RELEVANCE" ], "type": "string", "description": "Sort tutors by a specific criterion.", "default": "" }, "searchText": { "title": "Search Text", "type": "string", "description": "Free-text search query to filter tutors (e.g., 'business English', 'exam preparation').", "default": "" }, "priceRange": { "title": "Price Range", "type": "string", "description": "Price range filter in format 'min-max' (e.g., '10-30' for tutors between $10 and $30 per hour).", "default": "" }, "currencyFactor": { "title": "Currency Factor", "type": "string", "description": "Currency conversion factor relative to USD. Default '1' means prices in USD. For EUR use the appropriate factor.", "default": "1" }, "filters": { "title": "Filters", "type": "array", "description": "Additional filter categories to request from the API. Normally you don't need to change this.", "default": [ "PRICE_RANGE", "COUNTRY_OF_BIRTH", "NATIVE", "SUPER_TUTOR", "PROFESSIONAL", "TIMES_AVAILABLE", "DAYS_AVAILABLE", "SPECIALTIES", "SORT_BY" ], "items": { "type": "string" } }, "cookies": { "title": "Cookies (optional)", "type": "string", "description": "Cookie string for authentication. Required to bypass Cloudflare protection. You can get this from your browser's Developer Tools (Network tab → request headers → Cookie). Only needed if the API blocks anonymous requests.", "default": "" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Using residential proxies may help avoid rate limiting.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }