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 json { "type": "list", "maxRequestsPerCrawl": 50 } #### Single Mode - Specific Schools json { "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: json { "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: json { "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 json { "type": "list", "maxRequestsPerCrawl": 100 } ### Specific School Analysis json { "type": "single", "startUrls": [ { "url": "https://ibo.org/school/001119/" } ], "maxRequestsPerCrawl": 1 } ### Regional School Survey json { "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)