International Schools Database Scraper

Scrapes school profiles from international-schools-database.com — extracting school name, location, curriculum, IB programs, tuition fees, accreditations, enrollment, contact info, and more. Covers approximately 12,000 international schools across 338+ cities worldwide.

What it does

The actor navigates the site hierarchically:

1. City index — discovers all city listing pages from /in (or accepts a list of city URLs directly)
2. City listings — extracts school profile links from each city page
3. School detail pages — parses structured JSON-LD data plus HTML elements to produce a rich school record

Each school record contains 21 fields sourced primarily from the site's embedded structured data (application/ld+json), supplemented by HTML extraction for phone numbers and waiting list status.

Input

Field	Type	Description
maxItems	integer	Maximum number of school profiles to scrape. Default: 10.
cityUrls	array	Optional list of city listing URLs (e.g. https://www.international-schools-database.com/in/dubai). Leave empty to scrape all cities.

Example inputs

Quick test — single city:

{
  "maxItems": 10,
  "cityUrls": ["https://www.international-schools-database.com/in/dubai"]
}

Multiple cities:

{
  "maxItems": 100,
  "cityUrls": [
    "https://www.international-schools-database.com/in/bangkok",
    "https://www.international-schools-database.com/in/singapore",
    "https://www.international-schools-database.com/in/dubai"
  ]
}

Full global crawl:

{
  "maxItems": 15000
}

Leave cityUrls empty and set maxItems to your desired limit (or omit it to scrape all schools).

Output

Each record contains:

Field	Description
school_name	Full name of the school
city	City where the school is located
country	Country name
country_code	ISO 2-letter country code (e.g. TH, AE, DE)
address	Full street address
curriculum	Comma-separated curricula (e.g. IB, British, American)
ib_programs	IB programme certifications (e.g. Diploma Programme, PYP)
age_range	Typical student age range (e.g. 2-18)
total_enrollment	Total number of students enrolled
accreditations	Comma-separated accreditations (e.g. CIS, BSO, IB)
school_group	School group or network (e.g. Nord Anglia, GEMS)
languages_of_instruction	Comma-separated languages of instruction
tuition_low	Minimum annual tuition
tuition_high	Maximum annual tuition
currency	Currency code for tuition figures
waiting_list	Waiting list status (Yes / No / unknown)
phone	School or admissions phone number
website	School's official website URL
school_url	Profile URL on international-schools-database.com
school_id	School slug identifier from URL
description	School overview description
scrapedAt	ISO timestamp when the record was scraped

Example output

{
  "school_name": "Agora International School Andorra",
  "city": "Andorra la Vella",
  "country": "Andorra",
  "country_code": "AD",
  "address": "Carrer de la Roda, 3, AD500 Andorra la Vella",
  "curriculum": "IB",
  "ib_programs": "Primary Years Programme, Middle Years Programme, Diploma Programme",
  "age_range": "2-18",
  "total_enrollment": 650,
  "accreditations": "IB World School",
  "school_group": "",
  "languages_of_instruction": "English, Spanish, Catalan",
  "tuition_low": 11900,
  "tuition_high": 17000,
  "currency": "EUR",
  "waiting_list": "No",
  "phone": "+376 737 460",
  "website": "https://www.agoraandorra.com",
  "school_url": "https://www.international-schools-database.com/in/andorra/agora-international-school-andorra",
  "school_id": "agora-international-school-andorra",
  "description": "Agora International School Andorra is a leading international school...",
  "scrapedAt": "2026-05-03T20:14:00.000Z"
}

Usage notes

• Start with a city URL for testing — Andorra (/in/andorra) has only 2 schools and completes in seconds
• Full global crawl discovers ~338 cities and ~12,000 schools; allow several hours with timeoutSecs: 21600
• Tuition fields are in the school's local currency — check currency to interpret values correctly
• waiting_list is extracted from the school's self-reported Q&A section; some schools do not fill this in (returns unknown)
• Residential proxies are used automatically to ensure reliable access from all regions

Performance

• Concurrency: up to 10 parallel requests
• Typical throughput: ~80-100 schools/minute in cloud
• Memory: 512 MB