{ "openapi": "3.0.1", "info": { "title": "Schoolspring Scraper", "description": "Search SchoolSpring's US K-12 job board by keyword, location or ZIP, district, or multiselect category, grade level, and job type filters, or look up job IDs. Every job includes the full description, tagged categories, the specific school, pay range, contact info, and the application link.", "version": "1.0", "x-build-id": "uvGa6ig8cO1wZfg1P" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~schoolspring-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-schoolspring-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/normdata~schoolspring-scraper/runs": { "post": { "operationId": "runs-sync-normdata-schoolspring-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/normdata~schoolspring-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-schoolspring-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Caps how many rows this run writes." }, "mode": { "title": "What to do", "enum": [ "search", "lookup" ], "type": "string", "description": "Search filters SchoolSpring's job board into a list. Look up resolves specific known job IDs directly.", "default": "search" }, "keyword": { "title": "Keyword (for Search)", "type": "string", "description": "Match jobs whose title or description contains this text." }, "location": { "title": "Location (for Search)", "type": "string", "description": "City, state, region, or ZIP code, e.g. \"Florida\", \"Austin, Texas\", or \"97124\"." }, "organization": { "title": "District or organization (for Search)", "type": "string", "description": "Match jobs from a specific school district or organization name." }, "domainName": { "title": "SchoolSpring district subdomain (for Search)", "type": "string", "description": "Scope the search to one district's own SchoolSpring site, e.g. \"framingham\" for framingham.schoolspring.com. Leave empty to search all districts nationwide." }, "jobTypeIds": { "title": "Job type (for Search)", "type": "array", "description": "Select one or more employment types. SchoolSpring's own filters only accept one value per search, so selecting several here runs one query per type and merges the results.", "items": { "type": "string", "enum": [ "1", "2", "20", "40", "41", "42" ], "enumTitles": [ "Full-time", "Part-time", "Summer", "After school/Evening", "Full-time Unpaid", "Part-time Unpaid" ] } }, "gradeLevelIds": { "title": "Grade level (for Search)", "type": "array", "description": "Select one or more grade levels. Selecting several runs one query per level and merges the results, same as job type.", "items": { "type": "string", "enum": [ "3", "5", "10", "15", "20", "25" ], "enumTitles": [ "Preschool", "Primary", "Intermediate", "Middle", "Secondary", "Post-secondary" ] } }, "categoryIds": { "title": "Category (for Search)", "type": "array", "description": "Select one or more job categories. Selecting several runs one query per category and merges the results, same as job type.", "items": { "type": "string", "enum": [ "15", "11", "300", "21", "26", "226", "16", "12", "19", "20", "14", "25", "222", "189", "23", "10", "17", "18", "24", "178", "288", "22", "176", "179", "177", "104", "195", "105", "106", "107", "108", "109", "194", "110", "51", "111", "112", "113", "192", "114", "115", "116", "117", "141", "118", "119", "120", "139", "121", "122", "123", "124", "125", "126", "127", "228", "73", "128", "129", "130", "140", "131", "132", "133", "134", "135", "103", "136", "137", "138", "45", "313", "46", "47", "48", "49", "50", "289", "303", "53", "204", "54", "43", "56", "55", "202", "52", "57", "291", "203", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "27", "71", "72", "304", "75", "76", "79", "77", "78", "191", "13", "80", "82", "81", "83", "84", "44", "85", "86", "87", "190", "89", "90", "91", "88", "92", "93", "95", "94", "96", "97", "98", "99", "100", "290", "101", "31", "102", "308", "164", "163", "186", "305", "225", "165", "220", "209", "216", "219", "206", "205", "211", "207", "208", "212", "213", "215", "218", "210", "217", "214", "292", "295", "294", "293", "224", "227", "223", "156", "232", "161", "157", "42", "150", "312", "152", "297", "158", "160", "151", "153", "187", "154", "201", "188", "302", "199", "301", "198", "200", "159", "184", "185", "229", "155", "231", "148", "230", "197", "149", "29", "310", "28", "145", "309", "221", "144", "142", "147", "306", "307", "311", "146", "8", "283", "285", "287", "296", "286", "284", "282", "281", "193", "174", "298", "172", "167", "173", "299", "170", "171", "168", "169", "175", "32", "166" ], "enumTitles": [ "Administration: Assistant Principal/Dean/Head", "Administration: Assistant/Deputy Superintendent/Chief", "Administration: Athletic/Activities Director", "Administration: Business/Finance", "Administration: Curriculum", "Administration: Development / Marketing", "Administration: Director/Coordinator/Manager", "Administration: Facilities", "Administration: Food Services", "Administration: Human Resources", "Administration: Principal/Dean/Head of School", "Administration: Public Affairs / Relations", "Administration: Pupil Personnel", "Administration: Safety/Security", "Administration: Special Education Director", "Administration: Superintendent", "Administration: Technology", "Administration: Transportation", "Administration: Vocational/Career Education", "Athletics & Activities: After School Programs", "Athletics & Activities: Aquatics (Natatorium)", "Athletics & Activities: Athletic/Activities Director", "Athletics & Activities: Coaching", "Athletics & Activities: Theater Production", "Athletics & Activities: Trainer", "Career and Technical Education: Agriculture", "Career and Technical Education: Allied Health", "Career and Technical Education: Automotive Body Repair", "Career and Technical Education: Automotive Mechanics", "Career and Technical Education: Aviation Technology", "Career and Technical Education: Building Maintenance", "Career and Technical Education: Carpentry", "Career and Technical Education: Child Care Education", "Career and Technical Education: Commercial Arts", "Career and Technical Education: Computer Science", "Career and Technical Education: Cosmetology", "Career and Technical Education: Culinary Arts", "Career and Technical Education: Dance", "Career and Technical Education: Dental Assisting", "Career and Technical Education: Drafting", "Career and Technical Education: Electronics", "Career and Technical Education: Emergency Medical", "Career and Technical Education: Firefighter Training", "Career and Technical Education: Forestry", "Career and Technical Education: Graphics Arts", "Career and Technical Education: Heavy Equipment Operation", "Career and Technical Education: Horticulture", "Career and Technical Education: Hospitality & Tourism", "Career and Technical Education: Industrial Electrician", "Career and Technical Education: Industrial Mechanics", "Career and Technical Education: Journalism", "Career and Technical Education: Landscaping", "Career and Technical Education: Law Enforcement", "Career and Technical Education: Machine Trades", "Career and Technical Education: Major Appliance Repair", "Career and Technical Education: Marine Mechanics", "Career and Technical Education: Marketing Education", "Career and Technical Education: Masonry", "Career and Technical Education: Metalworking", "Career and Technical Education: Millwork & Cabinet Making", "Career and Technical Education: Music", "Career and Technical Education: Plumbing & Heating", "Career and Technical Education: Residential Wiring", "Career and Technical Education: Small Implement Mechanics", "Career and Technical Education: Stone Trades", "Career and Technical Education: Technical Theatre Design", "Career and Technical Education: Theater", "Career and Technical Education: Truck Operation & Repair", "Career and Technical Education: Welding & Cutting", "Career and Technical Education: Woodworking", "Classroom Teacher: Accounting", "Classroom Teacher: Alternative Learning Environment", "Classroom Teacher: Art", "Classroom Teacher: Arts: Dance", "Classroom Teacher: Arts: Drama", "Classroom Teacher: Bilingual Education", "Classroom Teacher: Business Education", "Classroom Teacher: Career and Technical Education", "Classroom Teacher: Computer Science", "Classroom Teacher: Driver Education", "Classroom Teacher: Early Childhood", "Classroom Teacher: Economics", "Classroom Teacher: Elementary", "Classroom Teacher: ELL / ESL / SEI / TESOL", "Classroom Teacher: English & Language Arts", "Classroom Teacher: Environmental Education", "Classroom Teacher: Family & Consumer Science", "Classroom Teacher: Health", "Classroom Teacher: High School / Secondary", "Classroom Teacher: JROTC Instructor", "Classroom Teacher: Keyboarding", "Classroom Teacher: Language: American Sign", "Classroom Teacher: Language: Arabic", "Classroom Teacher: Language: Chinese", "Classroom Teacher: Language: French", "Classroom Teacher: Language: German", "Classroom Teacher: Language: Greek", "Classroom Teacher: Language: Hebrew", "Classroom Teacher: Language: Italian", "Classroom Teacher: Language: Japanese", "Classroom Teacher: Language: Korean", "Classroom Teacher: Language: Latin", "Classroom Teacher: Language: Polish", "Classroom Teacher: Language: Portuguese", "Classroom Teacher: Language: Russian", "Classroom Teacher: Language: Spanish", "Classroom Teacher: Marketing Education", "Classroom Teacher: Math: Algebra", "Classroom Teacher: Math: Calculus", "Classroom Teacher: Math: General", "Classroom Teacher: Math: Geometry", "Classroom Teacher: Math: Trigonometry", "Classroom Teacher: Middle Grades", "Classroom Teacher: Montessori", "Classroom Teacher: Music Education", "Classroom Teacher: Music: Chorus", "Classroom Teacher: Music: Instrumental", "Classroom Teacher: Physical Education", "Classroom Teacher: Political Science", "Classroom Teacher: Preschool", "Classroom Teacher: Public Speaking", "Classroom Teacher: Reading/Literacy", "Classroom Teacher: Religion", "Classroom Teacher: Science: Astronomy", "Classroom Teacher: Science: Biology", "Classroom Teacher: Science: Chemistry", "Classroom Teacher: Science: Earth & Space", "Classroom Teacher: Science: General", "Classroom Teacher: Science: Geology", "Classroom Teacher: Science: Physics", "Classroom Teacher: Social Studies: Current Issues", "Classroom Teacher: Social Studies: General", "Classroom Teacher: Social Studies: Geography", "Classroom Teacher: Social Studies: Government", "Classroom Teacher: Social Studies: Military", "Classroom Teacher: Social Studies: US History", "Classroom Teacher: Social Studies: World History", "Classroom Teacher: STEM/STEAM", "Classroom Teacher: Technology/Industrial Arts", "Classroom Teacher: Title I", "Classroom Teacher: Video Production", "Instructional Support: Educational Technology", "Instructional Support: Individual Aide", "Instructional Support: Paraprofessional / IA", "Instructional Support: Permanent Substitute", "Instructional Support: Speech/Language Assistant", "Instructional Support: Teacher Mentor", "Instructional Support: Tutor", "Organization-level Positions: Analyst", "Organization-level Positions: Assistant Director", "Organization-level Positions: Assistant Manager", "Organization-level Positions: Assistant Officer", "Organization-level Positions: Asst. Commissioner/Superintendent", "Organization-level Positions: Commissioner/Superintendent", "Organization-level Positions: Consultant", "Organization-level Positions: Coordinator", "Organization-level Positions: Director/Division Director", "Organization-level Positions: Grants Monitor", "Organization-level Positions: Investigator", "Organization-level Positions: Manager", "Organization-level Positions: Officer", "Organization-level Positions: Specialist", "Organization-level Positions: Statistician", "Organization-level Positions: Unit Administrator", "Other Professional: Other Certified Professional", "Other Professional: Other Classified Professional", "Other Professional: Other Professional", "Other Professional: Teacher Mentor", "Seasonal/Other Opportunities: Online/Remote", "Seasonal/Other Opportunities: Sales/Consulting", "Seasonal/Other Opportunities: Summer Camps/Programs", "Special Education: Adaptive Physical Education", "Special Education: Alternative Learning Environment", "Special Education: Autism", "Special Education: Behavior Specialist / EBD", "Special Education: Consulting Teacher", "Special Education: Early Essential Education", "Special Education: Educational Diagnostician", "Special Education: Emotionally Disabled", "Special Education: Excessive Needs/Severe/Profound Disabilities", "Special Education: General Special Education", "Special Education: Gifted & Talented", "Special Education: Hard of Hearing", "Special Education: Learning Disabled", "Special Education: Life Skills", "Special Education: Mentally Disabled", "Special Education: Mild/Moderate Disabilities", "Special Education: Multiple Disabilities", "Special Education: Occupational Therapist", "Special Education: OT Assistant", "Special Education: Physical Therapist", "Special Education: PT Assistant", "Special Education: Severe/Profound Disabilities", "Special Education: Special Education Assistant", "Special Education: Speech/Language Assistant", "Special Education: Speech/Language Pathologist", "Special Education: Transition Specialist", "Special Education: Visually Impaired", "Student Services: Adjustment Counselor", "Student Services: Audiologist", "Student Services: Educational Diagnostician", "Student Services: Educational Technology", "Student Services: Librarian/Media Specialist", "Student Services: Occupational Therapist", "Student Services: OT Assistant", "Student Services: Physical Therapist", "Student Services: Psychologist", "Student Services: PT Assistant", "Student Services: Pupil Personnel Worker", "Student Services: School Nurse", "Student Services: School/Guidance Counselor", "Student Services: Social Worker", "Student Services: Speech/Language Assistant", "Student Services: Speech/Language Pathologist", "Student Services: Teacher Mentor", "Student Services: Translator", "Substitute: Substitute", "Substitute: Substitute: Clerical", "Substitute: Substitute: Custodial", "Substitute: Substitute: Food Service", "Substitute: Substitute: Instructional", "Substitute: Substitute: Library/Media Center Specialist", "Substitute: Substitute: Nurse", "Substitute: Substitute: Paraprofessional", "Substitute: Substitute: Teachers", "Support Staff: Accounting/Bookkeeping", "Support Staff: Administrative Assistant", "Support Staff: Clerical", "Support Staff: Computer Support", "Support Staff: Custodian", "Support Staff: Food Service", "Support Staff: Human Resources", "Support Staff: Maintenance", "Support Staff: Network Services", "Support Staff: Receptionist", "Support Staff: Safety/Security", "Support Staff: Secretary", "Support Staff: Supervisory Aide", "Support Staff: Transportation" ] } }, "postedWithinDays": { "title": "Posted within days (for Search)", "minimum": 1, "type": "integer", "description": "Only jobs posted or last displayed within this many days. Leave empty for no limit." }, "minPay": { "title": "Minimum pay (for Search)", "minimum": 0, "type": "number", "description": "Only jobs whose listed pay meets or exceeds this number. Districts list pay as either hourly or annual, so a high value here only matches annual salaries. Jobs with no numeric pay listed are excluded. Leave empty for no limit." }, "jobIds": { "title": "Job IDs (for Look up)", "type": "array", "description": "Known SchoolSpring job IDs to resolve directly. Unmatched IDs come back as an error row.", "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }