{ "openapi": "3.0.1", "info": { "title": "QS Top Universities Scraper", "description": "[💰 $4 / 1K] Extract QS university rankings from topuniversities.com — rank, score, country, city and the full indicator breakdown. 21 ranking tables, 59 subjects, editions 2021-2027, 105 countries. Filter by country, region or university name.", "version": "1.0", "x-build-id": "OSE1XIfLi6M7TDjl2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~topuniversities-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-topuniversities-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~topuniversities-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-topuniversities-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~topuniversities-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-topuniversities-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": { "ranking": { "title": "Ranking", "enum": [ "world-university-rankings", "sustainability-rankings", "employability-rankings", "asia-university-rankings", "europe-university-rankings", "latin-america-caribbean-rankings", "arab-region-university-rankings", "sub-saharan-africa-university-rankings", "mba-rankings/global", "mba-rankings/united-states", "mba-rankings/europe", "mba-rankings/asia", "mba-rankings/canada", "mba-rankings/latin-america", "mba-rankings/middle-east-africa", "mba-rankings/oceania", "business-masters-rankings/management", "business-masters-rankings/finance", "business-masters-rankings/marketing", "business-masters-rankings/business-analytics", "business-masters-rankings/supply-chain-management" ], "type": "string", "description": "Which QS ranking table to extract. The QS World University Rankings is the flagship global table. Ignored if you select one or more subjects below, or paste ranking URLs." }, "subjects": { "title": "Subjects (QS Rankings by Subject)", "uniqueItems": true, "type": "array", "description": "Extract the QS Rankings by Subject tables instead. Select one or more subjects and each becomes its own ranking table. Leave empty to use the Ranking choice above.", "items": { "type": "string", "enum": [ "accounting-finance", "agriculture-forestry", "anatomy-physiology", "anthropology", "archaeology", "architecture-built-environment", "art-design", "art-history", "arts-humanities", "biological-sciences", "business-management-studies", "chemical-engineering", "chemistry", "civil-structural-engineering", "classics-ancient-history", "communication-media-studies", "computer-science-information-systems", "data-science-artificial-intelligence", "dentistry", "development-studies", "earth-marine-sciences", "economics-econometrics", "education-training", "electrical-electronic-engineering", "engineering-petroleum", "engineering-technology", "english-language-literature", "environmental-sciences", "geography", "geology", "geophysics", "history", "hospitality-leisure-management", "law-legal-studies", "library-information-management", "life-sciences-medicine", "linguistics", "marketing", "materials-sciences", "mathematics", "mechanical-aeronautical-manufacturing-engineering", "medicine", "mineral-mining-engineering", "modern-languages", "music", "natural-sciences", "nursing", "performing-arts", "pharmacy-pharmacology", "philosophy", "physics-astronomy", "politics", "psychology", "social-policy-administration", "social-sciences-management", "sports-related-subjects", "statistics-operational-research", "theology-divinity-religious-studies", "veterinary-science" ], "enumTitles": [ "Accounting & Finance", "Agriculture & Forestry", "Anatomy & Physiology", "Anthropology", "Archaeology", "Architecture & Built Environment", "Art & Design", "Art History", "Arts & Humanities (broad faculty)", "Biological Sciences", "Business & Management Studies", "Engineering - Chemical", "Chemistry", "Engineering - Civil & Structural", "Classics & Ancient History", "Communication & Media Studies", "Computer Science & Information Systems", "Data Science & Artificial Intelligence", "Dentistry", "Development Studies", "Earth & Marine Sciences", "Economics & Econometrics", "Education & Training", "Engineering - Electrical & Electronic", "Engineering - Petroleum", "Engineering & Technology (broad faculty)", "English Language & Literature", "Environmental Sciences", "Geography", "Geology", "Geophysics", "History", "Hospitality & Leisure Management", "Law & Legal Studies", "Library & Information Management", "Life Sciences & Medicine (broad faculty)", "Linguistics", "Marketing", "Materials Sciences", "Mathematics", "Engineering - Mechanical, Aeronautical & Manufacturing", "Medicine", "Engineering - Mineral & Mining", "Modern Languages", "Music", "Natural Sciences (broad faculty)", "Nursing", "Performing Arts", "Pharmacy & Pharmacology", "Philosophy", "Physics & Astronomy", "Politics", "Psychology", "Social Policy & Administration", "Social Sciences & Management (broad faculty)", "Sports-Related Subjects", "Statistics & Operational Research", "Theology, Divinity & Religious Studies", "Veterinary Science" ] } }, "year": { "title": "Edition Year", "enum": [ "2027", "2026", "2025", "2024", "2023", "2022", "2021" ], "type": "string", "description": "Which edition of the ranking to extract. Older editions are not published for every ranking — when an edition is unavailable the latest one is used instead and the run log tells you so. Every row carries the edition it actually came from. Ignored when you paste ranking page URLs below." }, "rankingUrls": { "title": "Ranking Page URLs", "uniqueItems": true, "type": "array", "description": "Paste topuniversities.com ranking page URLs to extract them directly, for example https://www.topuniversities.com/asia-university-rankings/eastern-asia. Useful for sub-regional tables and older editions. When set, these are used instead of the choices above — including the Edition Year, which is taken from the URL itself. Repeated links to the same page are collected only once.", "items": { "type": "string" } }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Only return universities based in these countries. Leave empty to include every country.", "items": { "type": "string", "enum": [ "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BY", "BE", "BA", "BR", "BN", "BG", "CA", "CL", "CN", "CO", "CR", "HR", "CU", "CY", "CZ", "DK", "DO", "EC", "EG", "EE", "ET", "FI", "FR", "GE", "DE", "GH", "GR", "GT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JP", "JO", "KZ", "KE", "KW", "KG", "LV", "LB", "LT", "LU", "MO", "MY", "MT", "MX", "MA", "NL", "NZ", "NG", "NO", "OM", "PK", "PS", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "SA", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SD", "SE", "CH", "SY", "TW", "TZ", "TH", "TN", "TR", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VE", "VN" ], "enumTitles": [ "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Bosnia & Herzegovina", "Brazil", "Brunei", "Bulgaria", "Canada", "Chile", "China (Mainland)", "Colombia", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Honduras", "Hong Kong SAR", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Latvia", "Lebanon", "Lithuania", "Luxembourg", "Macau SAR", "Malaysia", "Malta", "Mexico", "Morocco", "Netherlands", "New Zealand", "Nigeria", "Norway", "Oman", "Pakistan", "Palestinian Territories", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Saudi Arabia", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sudan", "Sweden", "Switzerland", "Syria", "Taiwan", "Tanzania", "Thailand", "Tunisia", "Türkiye", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam" ] } }, "region": { "title": "Region", "enum": [ "", "Africa", "Asia", "Europe", "Latin America", "North America", "Oceania" ], "type": "string", "description": "Only return universities in this world region. Leave on 'All regions' for no region filter." }, "searchQuery": { "title": "University Name Search", "type": "string", "description": "Only return universities whose name matches this text, for example 'Oxford' or 'Technical University'. Leave empty for no name filter." }, "maxResults": { "title": "Maximum Results per Ranking", "minimum": 0, "type": "integer", "description": "How many universities to collect from each ranking table. Set to 0 to collect the whole table. Results arrive in blocks of up to 200 rows, so a request that isn't a round number may return a few extra rows — for example 250 returns 250, and 201 returns 202. This applies per ranking, so selecting several subjects multiplies the total." }, "sortOrder": { "title": "Start From", "enum": [ "asc", "desc" ], "type": "string", "description": "Whether to collect from the top of the ranking down, or from the bottom up. Only matters when you limit the number of results." }, "includeIndicatorScores": { "title": "Include Indicator Scores", "type": "boolean", "description": "Include the per-indicator score and rank breakdown for each university, such as Academic Reputation, Employer Reputation and Citations per Faculty. Turn off for a slimmer, faster result." } } }, "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 } } } } } } } } } }