IB School Finder API

Extract comprehensive information about IB (International Baccalaureate) schools worldwide from the official IB organization website. This scraper provides detailed school profiles including contact information, programme details, and geographical data.

What You Can Extract

School Information

• Basic Details: School name, type, IB school code, country, region
• Leadership: Head of school information
• History: IB school authorization date
• Contact: Website and online presence
• Location: Geographical coordinates for mapping
• Programmes: Available IB programmes, language of instruction, gender type, boarding facilities

Programme Details

• Authorization: Programme authorization status and dates
• Language: Primary language of instruction
• Gender: Co-educational or single-gender schools
• Boarding: Day school or boarding facilities available
• Examinations: Examination session information

Input Parameters

Parameter	Type	Default	Description
type	String	"list"	Required - Scraping mode: "list" (all schools) or "single" (specific URLs)
startUrls	Array	-	URLs to process (required when type is "single")
maxRequestsPerCrawl	Integer	2	Maximum number of pages to process (1-10000)

Input Examples

List Mode - All Schools

{
  "type": "list",
  "maxRequestsPerCrawl": 50
}

Single Mode - Specific Schools

{
  "type": "single",
  "startUrls": [
    {
      "url": "https://ibo.org/school/001119/"
    },
    {
      "url": "https://ibo.org/school/001874/"
    }
  ],
  "maxRequestsPerCrawl": 10
}

Output

The scraper provides two types of output:

1. School Dataset

Each scraped school is saved to the dataset with comprehensive information:

{
  "url": "https://ibo.org/school/001119/",
  "title": "'ITESM' (Campus Ciudad de México) - International Baccalaureate®",
  "schoolName": "'ITESM' (Campus Ciudad de México)",
  "type": "PRIVATE",
  "headOfSchool": "Luis Zuñiga",
  "ibSchoolSince": "19 April 1999",
  "country": "MEXICO",
  "region": "IB Americas",
  "ibSchoolCode": "001119",
  "website": "www.itesm.mx/wps/wcm/connect/Campus/CCM/Ciudad+de+Mexico/",
  "websiteUrl": "http://www.itesm.mx/wps/wcm/connect/Campus/CCM/Ciudad+de+Mexico/",
  "coordinates": {
    "latitude": 19.4106,
    "longitude": -99.1306
  },
  "programmes": {
    "authorised": "19 April 1999",
    "languageOfInstruction": "SPANISH",
    "gender": "COEDUCATIONAL",
    "boardingFacilities": "DAY",
    "examinations": "MAY"
  }
}

2. Statistics

Comprehensive crawling statistics for tracking and monitoring:

{
  "type": "list",
  "maxRequestsPerCrawl": 50,
  "schoolsScraped": 25,
  "startTime": "2025-11-08T10:46:08.858Z",
  "completedAt": "2025-11-08T10:48:21.927Z",
  "errors": [],
  "urlsProcessed": [
    "https://ibo.org/programmes/find-an-ib-school/ibaem/o2/international-school-of-hellerup/",
    "https://ibo.org/programmes/find-an-ib-school/ibla/k/knightsbridge-schools-international-bogota/"
  ]
}

Usage Examples

Country-Level Research

{
  "type": "list",
  "maxRequestsPerCrawl": 100
}

Specific School Analysis

{
  "type": "single",
  "startUrls": [
    {
      "url": "https://ibo.org/school/001119/"
    }
  ],
  "maxRequestsPerCrawl": 1
}

Regional School Survey

{
  "type": "list",
  "maxRequestsPerCrawl": 200
}

Use Cases

📚 Educational Research

• Analyze IB school distribution by country and region
• Study programme availability across different schools
• Research boarding facilities and educational offerings

🗺️ Geographic Analysis

• Map IB school locations using coordinate data
• Identify educational service gaps in specific regions
• Support location-based educational planning

📊 Market Research

• Analyze school types and educational sectors
• Study language of instruction patterns
• Research gender-specific educational offerings

🎯 School Selection

• Help families find IB schools in specific regions
• Compare programme offerings across schools
• Support educational consulting services

How to Use

1. Configure Input: Choose between "list" mode for comprehensive data or "single" mode for specific schools
2. Set Parameters: Configure request limits and provide URLs for single mode
3. Run Scraper: Execute the actor to collect school data
4. Access Results: Download structured school data from the dataset
5. Review Statistics: Check comprehensive crawling statistics

Important Notes

• Data Source: Official IB organization website (ibo.org)
• Data Accuracy: Information reflects current IB school listings
• Rate Limiting: Respect website rate limits, use appropriate delays
• Data Usage: Follow IB organization's terms of service for data usage
• Geographic Coverage: Includes IB schools worldwide across all regions

Data Fields Explained

• schoolName: Official school name as listed by IB
• type: School classification (PRIVATE, PUBLIC, etc.)
• ibSchoolSince: Date when school became authorized IB school
• region: IB administrative region (IB Americas, IB Africa, Europe, Middle East, IB Asia-Pacific)
• coordinates: Precise geographical location for mapping applications
• programmes.authorised: Authorization status and dates for IB programmes
• programmes.examinations: Examination session (MAY, NOVEMBER)