# Idealist Scraper (`crawlerbros/idealist-scraper`) Actor Scrape Idealist.org - the world's largest volunteer opportunity, nonprofit job, internship, and event listing directory. Search by keyword, cause area, location, remote/on-site, organization type, and more. - **URL**: https://apify.com/crawlerbros/idealist-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Jobs, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Idealist Scraper Scrape **Idealist.org** — the world's largest directory of volunteer opportunities, nonprofit jobs, internships, events, and mission-driven organizations. Search by keyword, cause area, location, organization type, and remote/on-site/hybrid, or look up specific listings by ID or URL. HTTP-only, no login, no API key, no cookies. ### What this actor does - **Two modes:** `search` (keyword + filters across all listing types) and `byIds` (exact lookup by listing ID or URL) - **5 listing types in one actor:** volunteer opportunities, nonprofit jobs, internships, events, and organizations - **Rich filters:** cause area, skill/role focus, organization type, work location (on-site/remote/hybrid), country, U.S. state, "can be done in a day", experience level, job type, education required, sort by best match or newest - **Full listing detail:** description, cause areas, skills, salary (jobs), event dates, organization mission and stats - **Empty fields are omitted** — every record only contains fields Idealist actually returned ### Output per listing - `listingId` — Idealist's unique listing ID - `listingType` — Volunteer Opportunity / Nonprofit Job / Internship / Event / Organization - `title`, `description`, `actionText` (short volunteer summary), `mission` (organizations) - `language` — content language of the listing (e.g. `en`, `es`) - `isAnonymous` — `true` if the poster chose to hide their identity (volunteer opportunities, jobs, internships) - `organizationId`, `organizationName`, `organizationType`, `organizationUrl` - `city`, `state`, `stateName`, `country`, `countryName` - `locationType` (On-site / Remote / Hybrid), `isRemote`, `remoteZone` - `latitude`, `longitude` - `causeAreas[]` — cause/issue areas (e.g. Education, Environment & Sustainability) - `categories[]` — skills / focus keywords - `postedAt` — ISO 8601 timestamp - Volunteer-opportunity fields: `canBeDoneInADay`, `welcomesGroups`, `welcomesFamilies`, `trainingProvided`, `stipendProvided`, `academicCreditAvailable`, `housingAvailable`, `welcomes[]` - Job fields: `isFullTime`, `jobTypes[]`, `professionalLevel`, `educationRequired`, `salaryMinimum`, `salaryMaximum`, `salaryPeriod`, `salaryCurrency` - Internship fields: `payment` - Event fields: `eventStartDate`, `eventEndDate`, `eventStartTime`, `eventEndTime`, `eventTimezone`, `eventStartsLocal`, `eventEndsLocal` - Organization fields: `isHiring`, `isSeekingVolunteers`, `hasUpcomingEvents` - `imageUrl`, `logoUrl` - `sourceUrl` — canonical Idealist listing/organization URL - `recordType: "listing"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byIds` | | `searchQuery` | string | `education` | Free-text keyword, skill, or interest (mode=search) | | `listingType` | string | `VOLOP` | Volunteer Opportunity / Nonprofit Job / Internship / Event / Organization / Any (mode=search) | | `orgType` | string | – | Nonprofit / Government / Corporation / Consultant / Community Group / Recruiter (mode=search) | | `locationType` | string | – | On-site / Remote / Hybrid (mode=search) | | `areaOfFocus` | string | – | Cause area, e.g. Education, Environment & Sustainability (mode=search) | | `skill` | string | – | Skill / role focus, e.g. Fundraising, Program Management, Social Media (mode=search) | | `country` | string | – | Restrict to a specific country (mode=search) | | `usState` | string | – | Restrict to a specific U.S. state (mode=search) | | `canBeDoneInADay` | boolean | `false` | Only volunteer opportunities completable in a single day (mode=search) | | `professionalLevel` | string | – | Experience level: Entry Level / Professional / Managerial / Director / Executive (mode=search, jobs) | | `jobType` | string | – | Full-time / Part-time / Temporary / Contract (mode=search, jobs) | | `education` | string | – | Minimum education required, e.g. High School, Four-Year Degree, J.D. (mode=search, jobs) | | `sortBy` | string | `relevance` | `relevance` (best match) / `newest` | | `listingIds` | array | – | Listing IDs or full listing URLs (mode=byIds) | | `maxItems` | int | `30` | Hard cap on emitted records (1–1000) | #### Example: education volunteer opportunities ```json { "mode": "search", "searchQuery": "education", "listingType": "VOLOP", "maxItems": 30 } ```` #### Example: remote nonprofit jobs in the environment sector ```json { "mode": "search", "listingType": "JOB", "locationType": "REMOTE", "areaOfFocus": "ENVIRONMENT", "sortBy": "newest", "maxItems": 50 } ``` #### Example: volunteer opportunities you can do in a day, near New York ```json { "mode": "search", "listingType": "VOLOP", "usState": "NY", "canBeDoneInADay": true, "maxItems": 50 } ``` #### Example: entry-level, full-time nonprofit jobs requiring a bachelor's degree ```json { "mode": "search", "listingType": "JOB", "professionalLevel": "ENTRY_LEVEL", "jobType": "FULL_TIME", "education": "FOUR_YEAR_DEGREE", "skill": "FUNDRAISING", "maxItems": 50 } ``` #### Example: look up specific listings by URL ```json { "mode": "byIds", "listingIds": [ "https://www.idealist.org/en/volunteer-opportunity/596b2f716d22498a94825ed15387d6e6-educational-support-volunteer-asovida-asociacion-de-amor-vida-y-salud-ong-antigua-guatemala" ] } ``` ### Use cases - **Corporate social responsibility teams** — source volunteer opportunities for employee engagement programs - **Nonprofit recruiters** — monitor competing nonprofit job postings by cause area or region - **Career sites & aggregators** — enrich a social-impact job board with Idealist listings - **Researchers & journalists** — analyze trends in nonprofit hiring, cause-area demand, or remote-work adoption in the social sector - **Volunteer-matching platforms** — cross-reference opportunities against Idealist's live listing set - **Students & job seekers** — bulk-export internships and entry-level nonprofit roles matching specific criteria ### FAQ **What data source does this actor use?** It queries idealist.org's own public listing search directly, the same data shown on the site's search pages. No login or API key is required. **Is this affiliated with Idealist.org?** No — this is an independent, third-party actor that reads Idealist's publicly accessible listing data. It is not affiliated with or endorsed by Idealist.org. **What's the difference between the listing types?** `VOLOP` (Volunteer Opportunity) and `EVENT` are unpaid; `JOB` and `INTERNSHIP` may be paid or unpaid depending on the posting; `ORG` returns organization profiles rather than individual postings. **Why do some records have fewer fields than others?** Only fields the source organization actually filled in are included — a listing without a specified salary simply omits the salary fields rather than showing an empty value. Field sets also differ by `listingType` (e.g. only jobs have `salaryMinimum`). **How many results can I get per search?** Idealist's listing search returns at most 1000 results for any single query/filter combination — this is a limit of the underlying search index, not of this actor. Narrow your `searchQuery` or filters (cause area, location, organization type) to reach more specific results within that limit. **How fresh is the data?** Every run queries Idealist live — there is no caching. Sort by `newest` to see the most recently posted listings first. **Can I filter to remote-only listings worldwide?** Yes — set `locationType` to `Remote` without setting `country` or `usState` to see remote listings from any location. **Does `canBeDoneInADay` apply to jobs and internships?** No, it's a volunteer-opportunity-specific attribute. It's silently ignored for other listing types. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text keyword, skill, or interest (e.g. "education", "data analyst", "environment"). Leave blank to browse the most recent listings for the selected type/filters. ## `listingType` (type: `string`): The kind of listing to search. ## `orgType` (type: `string`): Restrict to listings posted by a specific kind of organization. ## `locationType` (type: `string`): Restrict to on-site, remote, or hybrid listings. ## `areaOfFocus` (type: `string`): Restrict to a specific cause area / issue focus. ## `country` (type: `string`): Restrict to listings located in a specific country. ## `usState` (type: `string`): Restrict to listings located in a specific U.S. state (only meaningful when country=United States, or left blank). ## `skill` (type: `string`): Restrict to listings tagged with a specific skill / role focus (Idealist's "Skills" search filter). ## `professionalLevel` (type: `string`): Restrict nonprofit-job listings to a specific experience level. ## `jobType` (type: `string`): Restrict nonprofit-job listings to full-time, part-time, temporary, or contract. ## `education` (type: `string`): Restrict nonprofit-job listings to a specific minimum education requirement. ## `canBeDoneInADay` (type: `boolean`): Only return volunteer opportunities that can be completed in a single day. ## `sortBy` (type: `string`): Order results by best match or by most recently posted. ## `listingIds` (type: `array`): Idealist listing IDs (32-character hex) or full listing URLs, e.g. https://www.idealist.org/en/volunteer-opportunity/-slug. ## `maxItems` (type: `integer`): Hard cap on emitted records. Idealist's search index exposes at most 1000 results per query/filter combination. ## Actor input object example ```json { "mode": "search", "searchQuery": "education", "listingType": "VOLOP", "orgType": "", "locationType": "", "areaOfFocus": "", "country": "", "usState": "", "skill": "", "professionalLevel": "", "jobType": "", "education": "", "canBeDoneInADay": false, "sortBy": "relevance", "listingIds": [], "maxItems": 30 } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing all scraped Idealist listings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "education", "listingType": "VOLOP", "orgType": "", "locationType": "", "areaOfFocus": "", "country": "", "usState": "", "skill": "", "professionalLevel": "", "jobType": "", "education": "", "canBeDoneInADay": false, "sortBy": "relevance", "listingIds": [], "maxItems": 30 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/idealist-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "education", "listingType": "VOLOP", "orgType": "", "locationType": "", "areaOfFocus": "", "country": "", "usState": "", "skill": "", "professionalLevel": "", "jobType": "", "education": "", "canBeDoneInADay": False, "sortBy": "relevance", "listingIds": [], "maxItems": 30, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/idealist-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "searchQuery": "education", "listingType": "VOLOP", "orgType": "", "locationType": "", "areaOfFocus": "", "country": "", "usState": "", "skill": "", "professionalLevel": "", "jobType": "", "education": "", "canBeDoneInADay": false, "sortBy": "relevance", "listingIds": [], "maxItems": 30 }' | apify call crawlerbros/idealist-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/idealist-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealist Scraper", "description": "Scrape Idealist.org - the world's largest volunteer opportunity, nonprofit job, internship, and event listing directory. Search by keyword, cause area, location, remote/on-site, organization type, and more.", "version": "1.0", "x-build-id": "ihve3fYBWTaCdzhob" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~idealist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-idealist-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/crawlerbros~idealist-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-idealist-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/crawlerbros~idealist-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-idealist-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byIds" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword, skill, or interest (e.g. \"education\", \"data analyst\", \"environment\"). Leave blank to browse the most recent listings for the selected type/filters.", "default": "education" }, "listingType": { "title": "Listing type (mode=search)", "enum": [ "", "VOLOP", "JOB", "INTERNSHIP", "EVENT", "ORG" ], "type": "string", "description": "The kind of listing to search.", "default": "VOLOP" }, "orgType": { "title": "Organization type (mode=search)", "enum": [ "", "NONPROFIT", "GOVERNMENT", "CORPORATION", "CONSULTANT", "COMMUNITY", "RECRUITER" ], "type": "string", "description": "Restrict to listings posted by a specific kind of organization.", "default": "" }, "locationType": { "title": "Work location (mode=search)", "enum": [ "", "ONSITE", "REMOTE", "HYBRID" ], "type": "string", "description": "Restrict to on-site, remote, or hybrid listings.", "default": "" }, "areaOfFocus": { "title": "Cause area (mode=search)", "enum": [ "", "COMMUNITY_DEVELOPMENT", "EDUCATION", "VOLUNTEERING", "HEALTH_MEDICINE", "SENIORS_RETIREMENT", "CHILDREN_YOUTH", "HOUSING_HOMELESSNESS", "ARTS_MUSIC", "HUMAN_RIGHTS_CIVIL_LIBERTIES", "ENVIRONMENT", "MENTAL_HEALTH", "WOMEN", "DISABILITY", "HUNGER_FOOD_SECURITY", "VETERANS", "ECONOMIC_DEVELOPMENT", "CIVIC_ENGAGEMENT", "FAMILY", "ANIMALS", "RELIGION_SPIRITUALITY", "INTERNATIONAL_RELATIONS", "SCIENCE_TECHNOLOGY", "SPORTS_RECREATION", "POVERTY", "DISASTER_RELIEF", "IMMIGRANTS_OR_REFUGEES", "POLICY", "JOB_WORKPLACE", "PHILANTHROPY", "LEGAL_ASSISTANCE", "CRIME_SAFETY", "RACE_ETHNICITY", "MEDIA", "ENTREPRENEURSHIP", "RESEARCH_SOCIAL_SCIENCE", "LGBTQ", "CLIMATE_CHANGE", "AGRICULTURE", "URBAN_AREAS", "RURAL_AREAS", "CONFLICT_RESOLUTION", "VICTIM_SUPPORT", "ENERGY", "SUBSTANCE_ABUSE_ADDICTION", "COMMUNICATIONS_ACCESS", "TRANSPORTATION", "FINANCIAL_LITERACY_PERSONAL_FINANCE", "PRISON_REFORM", "SEXUAL_ABUSE_HUMAN_TRAFFICKING", "REPRODUCTIVE_HEALTH_RIGHTS", "CONSUMER_PROTECTION", "WATER_SANITATION", "MEN", "TRAVEL_HOSPITALITY", "TRANSPARENCY_OVERSIGHT", "MICROFINANCE" ], "type": "string", "description": "Restrict to a specific cause area / issue focus.", "default": "" }, "country": { "title": "Country (mode=search)", "enum": [ "", "US", "AR", "CA", "GB", "IN", "MX", "UG", "CO", "FR", "ES", "BR", "KE", "PE", "GH", "EC", "TZ", "AU", "NG", "NP", "DE", "ZA", "GT", "CM", "CL", "TH", "NL", "CH", "VE", "CR", "KH", "BO", "TG", "BE", "PK", "IL", "DO", "IT", "HN", "ID", "PH", "IE", "NI", "CN", "UY", "GR", "HT", "PR", "RW", "ZM", "SN", "NZ", "VN", "CD", "MA", "LR", "SL", "PS", "PA", "RO", "DK", "LK", "MY", "MW", "BD", "CI", "SE", "PT", "BJ", "PL", "JP", "EG", "SV", "UA", "MZ", "RU", "SG", "AT", "KR", "ET", "MG", "PY", "HK", "BZ", "SO", "BF", "MM", "BG", "ZW", "CZ", "AF", "LA", "HU", "NO", "GM", "JO", "LB", "TR", "RS", "LT", "HR" ], "type": "string", "description": "Restrict to listings located in a specific country.", "default": "" }, "usState": { "title": "U.S. state (mode=search)", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR" ], "type": "string", "description": "Restrict to listings located in a specific U.S. state (only meaningful when country=United States, or left blank).", "default": "" }, "skill": { "title": "Skill (mode=search)", "enum": [ "", "HOSPICE_CARE", "PEOPLE_SKILLS", "HEALTH_WELLNESS", "PATIENT_CARE", "ELDER_CARE", "COMMUNITY_ENGAGEMENT_OUTREACH", "HEALTHCARE_PROVIDER_PRACTITIONER", "ADMINISTRATIVE_OFFICE_SUPPORT", "VETERAN_CARE", "ADVOCACY", "RELATIONSHIP_BUILDING", "COUNSELING", "COMMUNICATIONS", "CUSTOMER_SERVICE", "READING_WRITING", "PUBLIC_SPEAKING", "CASE_SOCIAL_WORK", "ARTS_CRAFTS", "FUNDRAISING", "DISASTER_RELIEF", "EDUCATION", "ANIMAL_THERAPY", "MENTOR_TUTOR", "MUSIC_THERAPY", "MUSIC", "COMMUNITY_BELONGING", "YOUTH_SERVICES", "PROBLEM_SOLVING", "MARKETING", "SOCIAL_MEDIA", "TECHNOLOGY_SUPPORT_WEB_DESIGN", "ANIMAL_CARE", "VOLUNTEER_COORDINATION", "TEACHING_AND_INSTRUCTION", "EVENT_SUPPORT", "PROJECT_MANAGEMENT", "COMMUNITY_ORGANIZING", "DATA_ENTRY", "RESEARCH", "LEADERSHIP", "NURSING", "NETWORKING", "PUBLIC_RELATIONS", "LANGUAGES", "BUSINESS_DEVELOPMENT", "CHILD_DEVELOPMENT", "ACCOUNTING_FINANCE", "OPERATIONS", "PROGRAM_MANAGEMENT", "VISUAL_ARTS", "GARDENING", "LOBBYING", "CONSERVATION", "STRATEGIC_PLANNING", "PHYSICAL_SERVICE", "FOOD_DELIVERY_DISTRIBUTION", "STEM", "PHOTOGRAPHY", "CORPORATE_RESPONSIBILITY", "FOOD_SERVICE", "GRAPHIC_DESIGN", "SPORTS_FITNESS_COACHING", "DATA_ANALYSIS", "ESL", "CHILD_WELFARE", "HUMAN_RESOURCES", "GRANTS_ADMINISTRATION", "DIRECT_SERVICES", "DIVERSITY_EQUITY_INCLUSION", "PROJECT_RESEARCH_STUDY", "CHILD_CARE", "WRITING_EDITORIAL", "BOARD_COMMITTEE", "TECHNOLOGY_IT", "CRISIS_INTERVENTION", "SUSTAINABILITY", "MASSAGE_THERAPY", "PARTNERSHIPS", "DESIGN", "EQUIPMENT_FACILITIES", "LEGAL", "DONATION_DRIVE", "ART_THERAPY", "CONSTRUCTION_HOME_REPAIR", "EMPLOYEE_ENGAGEMENT", "DATABASE_ADMINISTRATION", "VIDEOGRAPHY", "CONFLICT_RESOLUTION", "ARCHIVING_DATA_ENTRY", "PUBLIC_HEALTH", "CORPORATE_PHILANTHROPY", "ADMINISTRATIVE", "WRITING_JOURNALISM", "DEVELOPMENT_FUNDRAISING", "HABITAT_RESTORATION", "FARMING", "THEATER", "STRATEGY_PLANNING", "TEACHING_INSTRUCTION", "CITIZENSHIP", "DANCE", "EVENTS", "DATA_EVALUATION_ANALYSIS", "INVESTIGATIONS", "MARKETING_COMMUNICATIONS", "ARTS_PHOTOGRAPHY", "SAFETY_RESOURCE_PROTECTION", "PHOTOGRAPHY_MEDIA_DESIGN", "SUPPLIES_PROCUREMENT_DISTRIBUTION", "STRATEGY", "GRANT_WRITING", "DATA_ENTRY_ANALYSIS" ], "type": "string", "description": "Restrict to listings tagged with a specific skill / role focus (Idealist's \"Skills\" search filter).", "default": "" }, "professionalLevel": { "title": "Experience level (mode=search, listingType=Nonprofit Job)", "enum": [ "", "ENTRY_LEVEL", "PROFESSIONAL", "MANAGERIAL", "DIRECTOR", "EXECUTIVE", "NONE" ], "type": "string", "description": "Restrict nonprofit-job listings to a specific experience level.", "default": "" }, "jobType": { "title": "Job type (mode=search, listingType=Nonprofit Job)", "enum": [ "", "FULL_TIME", "PART_TIME", "TEMPORARY", "CONTRACT" ], "type": "string", "description": "Restrict nonprofit-job listings to full-time, part-time, temporary, or contract.", "default": "" }, "education": { "title": "Education required (mode=search, listingType=Nonprofit Job)", "enum": [ "", "NO_REQUIREMENT", "HIGH_SCHOOL", "TWO_YEAR_DEGREE", "FOUR_YEAR_DEGREE", "MASTERS_DEGREE", "JD", "MD", "PHD", "OTHER" ], "type": "string", "description": "Restrict nonprofit-job listings to a specific minimum education requirement.", "default": "" }, "canBeDoneInADay": { "title": "Can be done in a day only (mode=search, listingType=Volunteer Opportunity)", "type": "boolean", "description": "Only return volunteer opportunities that can be completed in a single day.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest" ], "type": "string", "description": "Order results by best match or by most recently posted.", "default": "relevance" }, "listingIds": { "title": "Listing IDs or URLs (mode=byIds)", "type": "array", "description": "Idealist listing IDs (32-character hex) or full listing URLs, e.g. https://www.idealist.org/en/volunteer-opportunity/-slug.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records. Idealist's search index exposes at most 1000 results per query/filter combination.", "default": 30 } } }, "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 } } } } } } } } } } ```