# Advanced uniRank Scraper — Colleges & Universities Worldwide (`morkerr/advanced-unirank-scraper`) Actor Extract 14,000+ university profiles from uniRank.org — rankings, tuition, accreditation, fields of study, admissions, enrollment, social media, and facilities across 200+ countries. Clean structured data for EdTech, enrollment marketing, or academic research. - **URL**: https://apify.com/morkerr/advanced-unirank-scraper.md - **Developed by:** [morkerr](https://apify.com/morkerr) (community) - **Categories:** Lead generation, Jobs, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 - $0.00499/1 records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Advanced uniRank Scraper Scrape the complete [uniRank](https://www.unirank.org) university directory — over 14,000 institutions across 200+ countries. Get rankings, tuition ranges, accreditation details, fields of study, admissions selectivity, enrollment data, social media links, on-campus facilities, and more. ### Features - **Full directory coverage** — 14,000+ universities across 200+ countries from uniRank.org - **Rich detail extraction** — 45+ fields per institution including world/country rankings, tuition (local & international), accreditation, fields of study, admissions selectivity, enrollment size, academic staff, facilities (library, housing, sports, hospital), social media, academic divisions, and memberships - **Flexible country selection** — Single country dropdown + additional countries text field for multi-country scraping - **Custom URLs** — Paste specific uniRank profile or listing URLs for targeted scraping - **Auto-discovery** — Scrapes all countries from the homepage when no country is selected - **Quick test mode** — Runs with sensible defaults when no input is provided (scrapes 1 university from Vatican City) - **Pagination handling** — Enqueues all detail pages from A-Z listing pages automatically - **Configurable** — Control max concurrency, max universities per country, and proxy settings ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `country` | select | — All Countries — | Primary country to scrape (shows country name with ISO code) | | `additionalCountries` | stringList | [] | Extra country ISO codes (e.g. `us`, `gb`, `de`) | | `startUrls` | stringList | [] | Specific uniRank URLs to scrape | | `includeDetails` | boolean | true | Scrape full profile pages (vs. listing-only) | | `maxPerCountry` | integer | 0 | Max universities per country (0 = no limit) | | `maxConcurrency` | integer | 10 | Parallel request count (1–50) | | `proxyConfiguration` | proxy | Apify proxy | Proxy settings | #### Country codes Use ISO 3166-1 alpha-2 country codes in the **Additional Countries** field. Examples: `us` (United States), `gb` (United Kingdom), `de` (Germany), `fr` (France), `jp` (Japan), `cn` (China), `in` (India), `au` (Australia), `br` (Brazil). #### Custom URL patterns The scraper recognizes these URL patterns: - **Detail page**: `https://www.unirank.org/us/uni/harvard-university/` - **Listing page**: `https://www.unirank.org/gb/a-z/` - **Continent page**: `https://www.unirank.org/europe/` - **Country page**: `https://www.unirank.org/fr/` ### Output Each university profile contains up to 45+ fields: | Category | Fields | |----------|--------| | Identity | `name`, `acronym`, `motto`, `colors`, `profileUrl` | | Location | `countryName`, `countryCode`, `town`, `address`, `phone`, `fax` | | Rankings | `countryRank`, `worldRank` | | Institution | `founded`, `control`, `entity`, `size`, `selectivity`, `acceptanceRate`, `religiousAffiliation` | | Tuition | `tuitionLocalUndergrad`, `tuitionLocalPostgrad`, `tuitionInternationalUndergrad`, `tuitionInternationalPostgrad` | | Enrollment | `enrollmentRange`, `academicStaffRange` | | Academics | `fieldsOffered`, `accreditation`, `programmaticAccreditations`, `academicDivisions`, `memberships` | | Facilities | `library`, `housing`, `sportsFacilities`, `hospital`, `campusSetting`, `academicCalendar` | | Services | `financialAid`, `studyAbroad`, `distanceLearning`, `academicCounseling`, `careerServices`, `hasDisabledStudents` | | Social | `socialMedia` | ### Use cases - **EdTech lead generation** — Build a database of university contacts for student recruitment - **Academic research** — Study global higher education trends, tuition costs, and accreditation patterns - **Enrollment marketing** — Identify target institutions by selectivity, size, location, and tuition range - **Competitive analysis** — Compare university rankings, program offerings, and institutional profiles ### Quick start 1. Select a **Primary Country** from the dropdown 2. (Optional) Add **Additional Countries** codes 3. (Optional) Paste **Custom URLs** for specific universities 4. Click **Start** (or run with no input for a quick test) ### Limits - uniRank has minimal anti-bot protection; 10 concurrent requests is a safe default - Increase `maxConcurrency` up to 50 for faster scraping of large countries (US: 1,717 universities) - The free tier of Apify proxy is sufficient for most scraping tasks ### License MIT # Actor input Schema ## `country` (type: `string`): Select one country from the dropdown. For additional countries, use the field below. ## `additionalCountries` (type: `array`): More country ISO codes to scrape alongside the primary country (e.g. us, gb, de). Leave empty if not needed. ## `startUrls` (type: `array`): Specific uniRank URLs to scrape — e.g. https://www.unirank.org/us/uni/harvard/ or https://www.unirank.org/gb/a-z/. Combine with Country selection above. ## `includeDetails` (type: `boolean`): When enabled, scrapes each university's detailed profile page (rankings, tuition, accreditation, fields of study, admissions, facilities, social media). When disabled, returns only listing data (rank, name, town) from the directory. ## `maxPerCountry` (type: `integer`): Maximum number of universities to scrape per country. Set to 0 for no limit (US has 1717, UK has 165, etc). ## `maxConcurrency` (type: `integer`): Number of pages to fetch in parallel. Higher values are faster but more aggressive. ## `proxyConfiguration` (type: `object`): Proxy settings. uniRank has minimal anti-bot protection, but using Apify proxy can help with rate limiting. ## Actor input object example ```json { "country": "", "additionalCountries": [], "startUrls": [], "includeDetails": true, "maxPerCountry": 0, "maxConcurrency": 10, "proxyConfiguration": { "useApifyProxy": true } } ```` # Actor output Schema ## `name` (type: `string`): No description ## `acronym` (type: `string`): No description ## `countryCode` (type: `string`): No description ## `countryName` (type: `string`): No description ## `countryRank` (type: `string`): No description ## `worldRank` (type: `string`): No description ## `town` (type: `string`): No description ## `profileUrl` (type: `string`): No description ## `founded` (type: `string`): No description ## `control` (type: `string`): No description ## `entity` (type: `string`): No description ## `size` (type: `string`): No description ## `selectivity` (type: `string`): No description ## `acceptanceRate` (type: `string`): No description ## `address` (type: `string`): No description ## `phone` (type: `string`): No description ## `fax` (type: `string`): No description ## `motto` (type: `string`): No description ## `colors` (type: `string`): No description ## `campusSetting` (type: `string`): No description ## `academicCalendar` (type: `string`): No description ## `religiousAffiliation` (type: `string`): No description ## `tuitionLocalUndergrad` (type: `string`): No description ## `tuitionLocalPostgrad` (type: `string`): No description ## `tuitionInternationalUndergrad` (type: `string`): No description ## `tuitionInternationalPostgrad` (type: `string`): No description ## `enrollmentRange` (type: `string`): No description ## `academicStaffRange` (type: `string`): No description ## `fieldsOffered` (type: `string`): No description ## `accreditation` (type: `string`): No description ## `programmaticAccreditations` (type: `string`): No description ## `library` (type: `string`): No description ## `housing` (type: `string`): No description ## `sportsFacilities` (type: `string`): No description ## `hospital` (type: `string`): No description ## `financialAid` (type: `string`): No description ## `studyAbroad` (type: `string`): No description ## `distanceLearning` (type: `string`): No description ## `academicCounseling` (type: `string`): No description ## `careerServices` (type: `string`): No description ## `hasDisabledStudents` (type: `string`): No description ## `socialMedia` (type: `string`): No description ## `academicDivisions` (type: `string`): No description ## `memberships` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("morkerr/advanced-unirank-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("morkerr/advanced-unirank-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call morkerr/advanced-unirank-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=morkerr/advanced-unirank-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Advanced uniRank Scraper — Colleges & Universities Worldwide", "description": "Extract 14,000+ university profiles from uniRank.org — rankings, tuition, accreditation, fields of study, admissions, enrollment, social media, and facilities across 200+ countries. Clean structured data for EdTech, enrollment marketing, or academic research.", "version": "1.8", "x-build-id": "8NqUmhzcCar12nYQE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/morkerr~advanced-unirank-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-morkerr-advanced-unirank-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/morkerr~advanced-unirank-scraper/runs": { "post": { "operationId": "runs-sync-morkerr-advanced-unirank-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/morkerr~advanced-unirank-scraper/run-sync": { "post": { "operationId": "run-sync-morkerr-advanced-unirank-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": { "country": { "title": "Primary Country", "enum": [ "", "bm", "ca", "us", "ai", "ag", "ar", "aw", "bs", "bb", "bz", "bo", "br", "ky", "cl", "co", "cr", "cu", "cw", "dm", "do", "ec", "sv", "gf", "gd", "gp", "gt", "gy", "ht", "hn", "jm", "mx", "ni", "pa", "py", "pe", "pr", "kn", "sx", "sr", "tt", "uy", "ve", "vi", "al", "ad", "at", "by", "be", "ba", "bg", "hr", "cz", "dk", "ee", "fi", "fr", "de", "gr", "hu", "is", "ie", "it", "lv", "li", "lt", "lu", "mt", "md", "mc", "me", "nl", "mk", "no", "pl", "pt", "ro", "ru", "sm", "rs", "sk", "si", "es", "se", "ch", "ua", "gb", "va", "dz", "ao", "bj", "bw", "bf", "bi", "cm", "cv", "cf", "td", "cg", "cd", "dj", "eg", "gq", "er", "sz", "et", "ga", "gm", "gh", "gn", "ci", "ke", "ls", "lr", "ly", "mg", "mw", "ml", "mr", "mu", "ma", "mz", "na", "ne", "ng", "re", "rw", "sn", "sc", "sl", "so", "za", "ss", "sd", "tz", "tg", "tn", "ug", "zm", "zw", "af", "am", "az", "bh", "bd", "bt", "bn", "kh", "cn", "cy", "tl", "ge", "hk", "in", "id", "ir", "iq", "il", "jp", "jo", "kz", "kr", "kw", "kg", "la", "lb", "mo", "my", "mv", "mn", "mm", "np", "kp", "om", "pk", "ps", "ph", "qa", "sa", "sg", "lk", "sy", "tw", "tj", "th", "tr", "tm", "ae", "uz", "vn", "ye", "au", "fj", "pf", "gu", "nc", "nz", "pg", "ws", "sb" ], "type": "string", "description": "Select one country from the dropdown. For additional countries, use the field below.", "default": "" }, "additionalCountries": { "title": "Additional Countries", "type": "array", "description": "More country ISO codes to scrape alongside the primary country (e.g. us, gb, de). Leave empty if not needed.", "items": { "type": "string" }, "default": [] }, "startUrls": { "title": "Custom URLs", "type": "array", "description": "Specific uniRank URLs to scrape — e.g. https://www.unirank.org/us/uni/harvard/ or https://www.unirank.org/gb/a-z/. Combine with Country selection above.", "items": { "type": "string" }, "default": [] }, "includeDetails": { "title": "Include full university profiles", "type": "boolean", "description": "When enabled, scrapes each university's detailed profile page (rankings, tuition, accreditation, fields of study, admissions, facilities, social media). When disabled, returns only listing data (rank, name, town) from the directory.", "default": true }, "maxPerCountry": { "title": "Max universities per country", "minimum": 0, "type": "integer", "description": "Maximum number of universities to scrape per country. Set to 0 for no limit (US has 1717, UK has 165, etc).", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of pages to fetch in parallel. Higher values are faster but more aggressive.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. uniRank has minimal anti-bot protection, but using Apify proxy can help with rate limiting.", "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 } } } } } } } } } } ```