{ "openapi": "3.0.1", "info": { "title": "US College Data Scraper — 139 Fields, All 6000+ Schools", "description": "Extract comprehensive US college/university data from College Scorecard API. 139 fields including tuition, admissions, earnings, debt, completion rates, demographics, and more. Supports advanced filtering and bulk export.", "version": "1.0", "x-build-id": "WHlfoMuseeiwKedML" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/commanding_hotdog~us-college-data-scraper-qingwa/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-commanding_hotdog-us-college-data-scraper-qingwa", "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/commanding_hotdog~us-college-data-scraper-qingwa/runs": { "post": { "operationId": "runs-sync-commanding_hotdog-us-college-data-scraper-qingwa", "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/commanding_hotdog~us-college-data-scraper-qingwa/run-sync": { "post": { "operationId": "run-sync-commanding_hotdog-us-college-data-scraper-qingwa", "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": { "searchMode": { "title": "🔍 Search Mode", "enum": [ "byState", "byName", "byOpeId", "topSchools" ], "type": "string", "description": "How to find schools", "default": "byState" }, "states": { "title": "States", "type": "string", "description": "State code(s), comma-separated. Examples: CA | NY,TX | CA,FL,IL", "default": "CA" }, "schoolName": { "title": "School Name", "type": "string", "description": "Partial match search. Examples: Stanford | Community College | University of", "default": "" }, "opeIds": { "title": "OPE IDs", "type": "string", "description": "Direct lookup by OPE ID(s), comma-separated", "default": "" }, "maxResults": { "title": "Max Results", "enum": [ "50", "100", "200", "500", "1000", "2000" ], "type": "string", "description": "How many schools to return. More results = higher cost ($0.005/result).", "default": "100" }, "ownershipType": { "title": "School Type", "enum": [ "all", "public", "privateNonprofit", "privateForProfit" ], "type": "string", "description": "Filter by ownership", "default": "all" }, "degreeLevel": { "title": "Degree Level", "enum": [ "all", "fourYear", "twoYear", "lessThanTwoYear" ], "type": "string", "description": "Highest degree offered", "default": "all" }, "admissionRate": { "title": "Admission Rate", "enum": [ "all", "open (90-100%)", "easy (60-90%)", "moderate (30-60%)", "selective (10-30%)", "elite (<10%)" ], "type": "string", "description": "Filter by selectivity", "default": "all" }, "tuitionRange": { "title": "Max Tuition", "enum": [ "all", "under_5000", "under_10000", "under_15000", "under_20000", "under_30000", "under_50000" ], "type": "string", "description": "Filter by in-state tuition", "default": "all" }, "earningsRange": { "title": "Min Earnings (10yr)", "enum": [ "all", "over_30000", "over_50000", "over_70000", "over_100000" ], "type": "string", "description": "Filter by median earnings 10 years after entry", "default": "all" }, "includeBasic": { "title": "Basic Info (name, location, type, accreditation)", "type": "boolean", "description": "Basic Info (name, location, type, accreditation)", "default": true }, "includeTuition": { "title": "Tuition & Costs (tuition, net price, room & board)", "type": "boolean", "description": "Tuition & Costs (tuition, net price, room & board)", "default": true }, "includeAdmissions": { "title": "Admissions (admission rate, SAT/ACT scores)", "type": "boolean", "description": "Admissions (admission rate, SAT/ACT scores)", "default": true }, "includeOutcomes": { "title": "Outcomes (completion, earnings, retention, repayment)", "type": "boolean", "description": "Outcomes (completion, earnings, retention, repayment)", "default": true }, "includeDemographics": { "title": "Demographics (enrollment, gender, race/ethnicity)", "type": "boolean", "description": "Demographics (enrollment, gender, race/ethnicity)", "default": false }, "includeFinancialAid": { "title": "Financial Aid (Pell Grant, loans, median debt)", "type": "boolean", "description": "Financial Aid (Pell Grant, loans, median debt)", "default": false }, "includeAcademics": { "title": "Academics (programs offered, degree counts)", "type": "boolean", "description": "Academics (programs offered, degree counts)", "default": false }, "includeLocation": { "title": "Location (latitude, longitude, locale type)", "type": "boolean", "description": "Location (latitude, longitude, locale type)", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "none", "earnings", "admission", "tuition_low" ], "type": "string", "description": "Sort results (earnings/admission: high→low, tuition: low→high)", "default": "none" }, "apiKey": { "title": "🔑 API Key (Optional)", "type": "string", "description": "⚠️ DEMO KEY may hit rate limits with large requests. Get your FREE key at https://api.data.gov/signup (instant, no credit card). With your own key: unlimited requests, faster scraping, no interruptions.", "default": "" } } }, "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 } } } } } } } } } }