{ "openapi": "3.0.1", "info": { "title": "RateMyProfessors Scraper", "description": "[💰 $0.8 / 1K] Extract RateMyProfessors professor profiles and student ratings. Search by school or professor name, or paste profile URLs. Get rating, difficulty, would-take-again %, top tags, and every student review. Ideal for education research and EdTech.", "version": "1.0", "x-build-id": "apX0To0Cm6O5jcQya" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~ratemyprofessors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-ratemyprofessors-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/solidcode~ratemyprofessors-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-ratemyprofessors-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/solidcode~ratemyprofessors-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-ratemyprofessors-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", "properties": { "schools": { "title": "Schools", "type": "array", "description": "School names (e.g. `Arizona State University`) or numeric RateMyProfessors school IDs (e.g. `15723`). The scraper finds all professors at each school. Add a school here to also narrow the professor-name search below.", "items": { "type": "string" } }, "professorNames": { "title": "Professor Names", "type": "array", "description": "Professor names to search for (e.g. `John Smith`). Returns matching professor profiles. If you also add a school above, the search is narrowed to that school.", "items": { "type": "string" } }, "startUrls": { "title": "RateMyProfessors URLs", "type": "array", "description": "Paste RateMyProfessors professor or school page URLs. A professor URL (e.g. `https://www.ratemyprofessors.com/professor/12345`) returns that professor; a school URL (e.g. `https://www.ratemyprofessors.com/school/1234`) returns all its professors. The type is detected automatically.", "items": { "type": "string" } }, "maxProfessors": { "title": "Max Professors per School / Search", "minimum": 0, "type": "integer", "description": "Maximum number of professors to collect per school or per name search. Set to 0 for as many as available. Note: RateMyProfessors returns at most ~10,000 professors per school or search, so a single school or search tops out around that number even at 0. Tip: start with 10-50 to test, then increase. Ignored for direct professor URLs (those return one professor each).", "default": 50 }, "includeRatings": { "title": "Include Student Ratings", "type": "boolean", "description": "For each professor, also collect individual student ratings (comment, course, quality and difficulty scores, grade, tags, and more). Ratings are added as separate rows linked to the professor. This adds work per professor, so it is slower and costs more. Turn off for professor summaries only.", "default": true }, "maxRatingsPerProfessor": { "title": "Max Ratings per Professor", "minimum": 0, "type": "integer", "description": "Maximum number of ratings to collect per professor when ratings are enabled. Set to 0 for all available. Note: popular professors can have hundreds to over a thousand ratings, so a low cap keeps runs fast and predictable.", "default": 100 } } }, "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 } } } } } } } } } }