{ "openapi": "3.0.1", "info": { "title": "Wyzant Tutors Scraper", "description": "Scrape tutor profiles from Wyzant.com with the largest US tutoring marketplace. Search tutors by subject or keyword, browse subject pages, or fetch individual tutor profiles. Returns name, subjects, hourly rate, rating, reviews, education, bio, and more.", "version": "1.0", "x-build-id": "IwKhIo0tTQzsRFCgq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlergang~wyzant-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlergang-wyzant-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/crawlergang~wyzant-scraper/runs": { "post": { "operationId": "runs-sync-crawlergang-wyzant-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/crawlergang~wyzant-scraper/run-sync": { "post": { "operationId": "run-sync-crawlergang-wyzant-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": [ "search", "bySubject", "tutorProfile", "byUrl" ], "type": "string", "description": "What to fetch from Wyzant.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Subject or keyword to search for tutors (mode=search), e.g. `calculus`, `python programming`, `SAT prep`.", "default": "math" }, "subject": { "title": "Subject", "enum": [ "math", "algebra", "calculus", "geometry", "statistics", "trigonometry", "science", "chemistry", "physics", "biology", "earth-science", "english", "reading", "writing", "grammar", "literature", "history", "us-history", "world-history", "government", "spanish", "french", "mandarin", "german", "japanese", "italian", "computer-science", "python", "java", "javascript", "c-programming", "html", "music", "piano", "guitar", "violin", "sat", "act", "gre", "gmat", "lsat", "business", "accounting", "economics", "finance", "marketing", "writing-essays" ], "type": "string", "description": "Browse tutors by subject category (mode=bySubject).", "default": "math" }, "tutorUsername": { "title": "Tutor username", "type": "string", "description": "Wyzant username for a single tutor profile (mode=tutorProfile), e.g. `john_s`." }, "startUrls": { "title": "Start URLs (mode=byUrl)", "type": "array", "description": "List of Wyzant tutor profile URLs (mode=byUrl). Each item must have a `url` key, e.g. `https://www.wyzant.com/tutors/john_s`.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlineOnly": { "title": "Online tutors only", "type": "boolean", "description": "If enabled, only return tutors available for online sessions.", "default": true }, "zipCode": { "title": "ZIP code (in-person filter)", "type": "string", "description": "US ZIP code to filter for nearby in-person tutors (optional). Leave blank for online-only search." }, "minRate": { "title": "Min hourly rate ($)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Minimum tutor hourly rate in USD." }, "maxRate": { "title": "Max hourly rate ($)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum tutor hourly rate in USD." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Minimum tutor rating (0.0 – 5.0)." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of tutor records to emit.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Uses Apify AUTO datacenter proxy for Wyzant access.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }