{ "openapi": "3.0.1", "info": { "title": "EduRank Scraper — 14,000 University Rankings", "description": "Scrape 14,000+ university rankings from EduRank.org — world/subject rankings, research metrics, prominence, and alumni scores across 183 countries.", "version": "1.18", "x-build-id": "cmKuEocrCPIV8hrIi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/morkerr~edurank-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-morkerr-edurank-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~edurank-scraper/runs": { "post": { "operationId": "runs-sync-morkerr-edurank-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~edurank-scraper/run-sync": { "post": { "operationId": "run-sync-morkerr-edurank-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", "gl", "pm", "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", "mq", "mx", "ms", "ni", "pa", "py", "pe", "pr", "bl", "kn", "lc", "mf", "vc", "sx", "sr", "tt", "tc", "uy", "ve", "vg", "vi", "al", "ad", "am", "at", "az", "by", "be", "ba", "bg", "hr", "cy", "cz", "dk", "ee", "fo", "fi", "fr", "ge", "de", "gi", "gr", "gg", "hu", "is", "ie", "im", "it", "je", "xk", "lv", "li", "lt", "lu", "mt", "md", "mc", "me", "nl", "mk", "no", "pl", "pt", "ro", "ru", "sm", "rs", "sk", "si", "es", "se", "ch", "tr", "ua", "gb", "va", "dz", "ao", "bj", "bw", "bf", "bi", "cm", "cv", "cf", "td", "km", "cg", "cd", "dj", "eg", "gq", "er", "sz", "et", "ga", "gm", "gh", "gn", "gw", "ci", "ke", "ls", "lr", "ly", "mg", "mw", "ml", "mr", "mu", "ma", "mz", "na", "ne", "ng", "re", "rw", "st", "sn", "sc", "sl", "so", "za", "ss", "sd", "tz", "tg", "tn", "ug", "eh", "zm", "zw", "af", "bh", "bd", "bt", "bn", "kh", "cn", "tl", "hk", "in", "id", "ir", "iq", "il", "jp", "jo", "kz", "kp", "kr", "kw", "kg", "la", "lb", "mo", "my", "mv", "mn", "mm", "np", "om", "pk", "ps", "ph", "qa", "sa", "sg", "lk", "sy", "tw", "tj", "th", "tm", "ae", "uz", "vn", "ye", "as", "au", "ck", "fj", "pf", "gu", "ki", "mh", "fm", "nr", "nc", "nz", "nu", "pw", "pg", "ws", "sb", "tk", "to", "tv", "vu", "wf" ], "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 EduRank URLs to scrape — e.g. https://edurank.org/uni/university-of-oxford/rankings/ or https://edurank.org/geo/us/. Combine with Country selection above.", "items": { "type": "string" }, "default": [] }, "branch-art-design": { "title": "Art & Design — Branches", "type": "array", "description": "Filter by Art & Design subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "aesthetics", "animation", "architecture", "art-history", "cinematography", "graphics", "creative-writing", "entertainment", "fashion", "game-design", "graphic-design", "illustration", "interior-design", "landscape-architecture", "literature", "multimedia", "music", "painting", "performing-arts", "photography", "sculpture", "singing", "ux-ui" ], "enumTitles": [ "Aesthetics", "Animation", "Architecture", "History", "Cinematography", "Computer Graphics", "Creative Writing", "Entertainment Industry", "Fashion Design", "Game design", "Graphic Design", "Illustration and Concept art", "Interior Design", "Landscape Architecture", "Literature", "Multimedia", "Music", "Painting and Drawing", "Acting and Drama", "Photography", "Sculpture", "Singing", "UX/UI Desgin" ] } }, "branch-biology": { "title": "Biology — Branches", "type": "array", "description": "Filter by Biology subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "agriculture", "animal-science", "astrobiology", "biochemistry", "bioethics", "bioinformatics", "biophysics", "biotechnology", "botany", "entomology", "evolutionary", "forestry", "genetics", "horticulture", "immunology", "microbiology", "molecular", "nanotechnology", "neuroscience", "nutrition", "oncology", "paleontology", "pharmacology", "toxicology", "virology", "wildlife", "zoology" ], "enumTitles": [ "Agricultural Science", "Animal Science", "Astrobiology", "Biochemistry", "Ethics", "Bioinformatics / Computational biology", "Biophysics", "Biotechnology", "Botany", "Entomology", "Evolutionary", "Forestry", "Genetics", "Horticulture", "Immunology", "Microbiology", "Molecular", "Nanotechnology", "Neuroscience", "Nutrition and Food Science", "Oncology", "Paleontology", "Pharmacology", "Toxicology", "Virology", "Wildlife and Fisheries Management", "Zoology" ] } }, "branch-business": { "title": "Business — Branches", "type": "array", "description": "Filter by Business subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "accounting", "actuarial-science", "advertising", "construction-management", "engineering-management", "entertainment", "entrepreneurship", "finance", "hospitality", "human-resources", "international-business", "international-trade", "investment", "management", "knowledge-management", "marketing", "occupational-safety", "operations-research", "project-management", "public-policy", "real-estate", "risk-management", "logistics", "tax" ], "enumTitles": [ "Accounting", "Actuarial Science", "Advertising", "Construction Management", "Engineering Management", "Entertainment Industry", "Entrepreneurship", "Finance", "Hospitality and Tourism", "Human Resources", "International Business", "International Trade", "Investment Banking", "Management", "Management Information Systems (MIS)", "Marketing", "Occupational Safety", "Operations Research", "Project Management", "Public Policy/Administration", "Real Estate", "Risk Management", "Logistics", "Tax Law" ] } }, "branch-chemistry": { "title": "Chemistry — Branches", "type": "array", "description": "Filter by Chemistry subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "biochemical-engineering", "biochemistry", "chemical", "computational", "environmental", "inorganic", "materials", "nanotechnology", "nutrition", "organic-chemistry", "geochemistry", "pharmacy", "physical", "polymers", "radiochemistry" ], "enumTitles": [ "Biochemical Engineering", "Biochemistry", "Chemical Engineering", "Computational", "Environmental Chemistry", "Inorganic", "Materials Science", "Nanotechnology", "Nutrition and Food Science", "Organic chemistry", "Petrology and Geochemistry", "Pharmacy", "Physical", "Polymer science and Plastics", "Radiochemistry" ] } }, "branch-cs": { "title": "Computer Science — Branches", "type": "array", "description": "Filter by Computer Science subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "animation", "ai", "bioinformatics", "cryptography", "cognitive-science", "computational-linguistics", "computer-engineering", "graphics", "network", "computer-vision", "cybersecurity", "data-science", "database", "game-design", "hci", "information-technology", "library", "machine-learning", "mis", "multimedia", "neuroscience", "robotics", "software-engineering", "telecommunications", "ux-ui", "web-design" ], "enumTitles": [ "Animation", "Artificial Intelligence (AI)", "Bioinformatics / Computational biology", "Cryptography and Distributed computing", "Cognitive Science", "Computational Linguistics", "Computer Engineering", "Computer Graphics", "Computer Networking", "Computer Vision", "Cyber Security", "Data Science", "Database Administration", "Game design", "Human-Computer Interaction", "Information Technology", "Library and Information science", "Machine Learning", "Management Information Systems (MIS)", "Multimedia", "Neuroscience", "Robotics", "Software Engineering", "Telecommunications", "UX/UI Desgin", "Web Development" ] } }, "branch-economics": { "title": "Economics — Branches", "type": "array", "description": "Filter by Economics subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "actuarial-science", "agricultural", "development", "econometrics", "environmental", "finance", "international", "international-affairs", "international-trade", "investment", "political" ], "enumTitles": [ "Actuarial Science", "Agricultural", "Development Studies", "Econometrics", "Environmental", "Finance", "International", "International Relations", "International Trade", "Investment Banking", "Political Economy" ] } }, "branch-engineering": { "title": "Engineering — Branches", "type": "array", "description": "Filter by Engineering subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "acoustics", "aerospace", "agricultural", "applied", "architectural", "architecture", "automation", "automotive", "aviation", "biochemical-engineering", "bioengineering", "biotechnology", "chemical", "civil", "computer-engineering", "network", "construction-management", "electrical", "electronic", "engineering-management", "environmental-eng", "firefighting", "geotechnical", "hci", "industrial", "landscape-architecture", "marine", "materials", "mechanical", "metallurgy", "mining", "nanotechnology", "nuclear-eng", "operations-research", "optics", "petroleum", "polymers", "industrial-design", "reliability", "remote-sensing", "renewable-energy", "robotics", "structural", "systems", "drawing", "telecommunications", "transportation" ], "enumTitles": [ "Acoustics", "Aerospace", "Agricultural", "Applied Physics", "Architectural Engineering", "Architecture", "Automation and Control", "Automotive", "Aviation", "Biochemical Engineering", "Biomedical Engineering", "Biotechnology", "Chemical Engineering", "Civil", "Computer Engineering", "Computer Networking", "Construction Management", "Electrical", "Electronic", "Engineering Management", "Environmental Engineering", "Fire Science", "Geotechnical Engineering", "Human-Computer Interaction", "Industrial", "Landscape Architecture", "Marine", "Materials Science", "Mechanical", "Metallurgy", "Mining", "Nanotechnology", "Nuclear Engineering", "Operations Research", "Optics", "Petroleum", "Polymer science and Plastics", "Product / Industrial Design", "Reliability and Quality", "Remote Sensing", "Renewable Energy", "Robotics", "Structural", "Systems", "Technical Drawing", "Telecommunications", "Transportation" ] } }, "branch-environmental-science": { "title": "Environmental Science — Branches", "type": "array", "description": "Filter by Environmental Science subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "agriculture", "geoscience", "ecology", "environmental-chem", "environmental-eng", "env-management", "forestry", "geography", "geology", "geotechnical", "hydrology", "meteorology", "mining", "oceanography", "paleontology", "geochemistry", "urban-planning", "wildlife" ], "enumTitles": [ "Agricultural Science", "Earth science and Geoscience", "Ecology", "Environmental Chemistry", "Environmental Engineering", "Environmental Management", "Forestry", "Geography", "Geology", "Geotechnical Engineering", "Hydrology and Water resources", "Meteorology and Atmospheric Science", "Mining", "Oceanography", "Paleontology", "Petrology and Geochemistry", "Urban and Regional planning", "Wildlife and Fisheries Management" ] } }, "branch-liberal-arts": { "title": "Liberal Arts & Social Sciences — Branches", "type": "array", "description": "Filter by Liberal Arts & Social Sciences subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "aesthetics", "anthropology", "archaeology", "art-history", "broadcast-journalism", "classics", "communications", "criminology", "demography", "early-education", "pedagogy", "forensic-science", "gender-studies", "genealogy", "history", "human-rights", "intellectual-property", "international-law", "international-affairs", "journalism", "law", "homeland-security", "library", "linguistics", "media-studies", "military", "negotiation", "occupational-safety", "philosophy", "political-economy", "political-science", "public-policy", "publishing", "radio-television", "social-work", "sociology", "special-education", "physical-education", "theology", "urban-planning" ], "enumTitles": [ "Aesthetics", "Anthropology", "Archaeology", "Art History", "Broadcast Journalism", "Classics and Ancient History", "Communications and Public Relations", "Criminology and Criminal Justice", "Demography", "Early Childhood Education", "Education", "Forensic Science", "Gender Studies", "Genealogy", "History", "Human Rights", "Intellectual Property", "International Law", "International Relations", "Journalism and Digital Media", "Law", "Law Enforcement", "Library and Information science", "Linguistics", "Media Studies", "Military science", "Conflict Resolution", "Occupational Safety", "Philosophy", "Political Economy", "Political Science", "Public Policy/Administration", "Publishing", "Radio and Television", "Social Work", "Sociology", "Special Education", "Sports / Exercise science", "Theology and Religious studies", "Urban and Regional planning" ] } }, "branch-mathematics": { "title": "Mathematics — Branches", "type": "array", "description": "Filter by Mathematics subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "actuarial-science", "applied", "cryptography", "econometrics", "math-education", "operations-research", "statistics" ], "enumTitles": [ "Actuarial Science", "Applied Mathematics", "Cryptography and Distributed computing", "Econometrics", "Mathematics Education", "Operations Research", "Statistics" ] } }, "branch-medicine": { "title": "Medicine — Branches", "type": "array", "description": "Filter by Medicine subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "physiology", "anesthesiology", "audiology", "bioethics", "bioengineering", "cardiology", "clinical-psychology", "cosmetology", "critical-care", "dentistry", "dermatology", "epidemiology", "family", "forensic-science", "gastroenterology", "gerontology", "health-science", "health-admin", "immunology", "medical", "neurosurgery", "nursing", "obgyn", "occupational-therapy", "oncology", "ophthalmology", "optometry", "orthodontics", "paramedicine", "pathology", "pediatrics", "pharmacology", "pharmacy", "physical-therapy", "plastic-surgery", "psychiatry", "public", "radiation-therapy", "radiology", "respiratory", "social-work", "sonography", "physical-education", "sports-med", "surgery", "toxicology", "urology", "veterinary", "virology" ], "enumTitles": [ "Anatomy / Physiology", "Anesthesiology", "Audiology", "Ethics", "Biomedical Engineering", "Cardiology", "Clinical Psychology", "Cosmetology", "Critical Care Nursing", "Dentistry", "Dermatology", "Epidemiology", "Family medicine", "Forensic Science", "Gastroenterology and Hepatology", "Gerontology", "Health Science", "Healthcare Administration", "Immunology", "Medical Physics", "Neurosurgery", "Nursing", "Obstetrics and Gynecology", "Occupational Therapy", "Oncology", "Ophthalmology", "Optometry", "Orthodontics", "Paramedicine and Emergency", "Pathology", "Pediatrics", "Pharmacology", "Pharmacy", "Physical Therapy", "Plastic Surgery", "Psychiatry", "Public Health", "Radiation Therapy", "Radiology", "Respiratory Therapy", "Social Work", "Sonography / Ultrasound", "Sports / Exercise science", "Sports Medicine", "Surgery", "Toxicology", "Urology", "Veterinary", "Virology" ] } }, "branch-physics": { "title": "Physics — Branches", "type": "array", "description": "Filter by Physics subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "acoustics", "applied", "astrobiology", "astrophysics", "molecular", "biophysics", "condensed-matter", "materials", "medical", "nanotechnology", "nuclear", "optics", "quantum", "theoretical" ], "enumTitles": [ "Acoustics", "Applied Physics", "Astrobiology", "Astrophysics and Astronomy", "Atomic and Molecular", "Biophysics", "Condensed Matter", "Materials Science", "Medical Physics", "Nanotechnology", "Nuclear", "Optics", "Quantum and Particle physics", "Theoretical" ] } }, "branch-psychology": { "title": "Psychology — Branches", "type": "array", "description": "Filter by Psychology subfields. Select one or more branches, or leave empty for no subfield filter.", "items": { "type": "string", "enum": [ "developmental", "clinical-psychology", "cognitive-science", "pedagogy", "negotiation", "neuroscience", "occupational-therapy", "organizational", "psychiatry", "sexology", "social", "social-work", "special-education" ], "enumTitles": [ "Developmental", "Clinical Psychology", "Cognitive Science", "Education", "Conflict Resolution", "Neuroscience", "Occupational Therapy", "Organizational Psychology", "Psychiatry", "Human Sexuality", "Social Psychology", "Social Work", "Special Education" ] } }, "dataSections": { "title": "Data Sections to Scrape", "type": "array", "description": "Choose which data sections to scrape for each university. Selecting fewer sections makes runs faster.", "items": { "type": "string", "enum": [ "research", "admissions", "general", "programs" ], "enumTitles": [ "Research Profile & Rankings — world/continent/country ranks, publications, citations, subjects, alumni", "Acceptance Rate & Admissions — acceptance rate, enrollment, applicants, student-faculty ratio, calendar", "General Information — motto, founded year, accreditation, colors, type, funding, website, address", "Programs & Degrees — tuition costs by program" ] }, "default": [ "research", "admissions", "general" ] }, "includeSubjectRankings": { "title": "Include subject rankings", "type": "boolean", "description": "When enabled, scrapes detailed subject-level rankings for each university (246+ research topics across 14 fields). When disabled, returns only overall ranking data.", "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 ~2500, UK ~163, 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. EduRank 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 } } } } } } } } } }