# US Apprenticeship Sponsor & Employer Leads Scraper (`scrapesage/apprenticeship-sponsor-leads-scraper`) Actor Scrape 26,000+ US registered apprenticeship program sponsors from official US DOL data: employers, union JATCs, colleges & training providers with contact name, email, phone, address, trade & registration date + lead score. Filter by state, trade, category & new sponsors. B2B leads + monitoring. - **URL**: https://apify.com/scrapesage/apprenticeship-sponsor-leads-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $6.00 / 1,000 apprenticeship sponsor leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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 ## US Apprenticeship Sponsor & Employer Leads Scraper Turn the official **U.S. Department of Labor Office of Apprenticeship** partner-sponsor registry into a clean, ready-to-use **B2B lead list**. Every organization that sponsors a **Registered Apprenticeship** program in the United States — **employers**, **union joint apprenticeship & training committees (JATCs)**, **community colleges & technical schools**, **workforce boards** and **industry associations / intermediaries** — with a **named contact, e-mail, phone, website, full mailing address**, the **program registration date** (a fresh "newly-registered sponsor" buying signal), a derived **sponsor category**, **trade hints** and a **0-100 lead score**. No login, no API key, no browser — one official, keyless government CSV, parsed into **~26,000+ structured sponsor leads** across all 50 states, DC, Puerto Rico, Guam and the territories. ### Why this scraper? Generic crawlers and the apprenticeship.gov Partner Finder let you *look at* sponsors one page at a time. This actor ships the **whole registry as one enriched, filterable dataset** — deduplicated, contact-normalized, categorized and lead-scored — so you can build a targeted prospecting list in seconds. | Data | apprenticeship.gov Partner Finder | This actor | |---|---|---| | Organization name & full address | ✅ (one page at a time) | ✅ all ~26k at once | | Contact person | partial | ✅ ~19% (cleaned & de-duplicated) | | **E-mail** | ❌ not exportable | ✅ ~58% | | **Phone** | ❌ not exportable | ✅ ~53% | | Website | partial | ✅ when published | | **Program registration date** (fresh-lead signal) | ❌ | ✅ 100% | | **Derived sponsor category** (employer / union JATC / college / workforce / association) | ❌ | ✅ | | **Trade / occupation hints** (electrical, plumbing, HVAC, healthcare, IT…) | ❌ | ✅ | | Filter by state, city, county, ZIP, trade, category, recency | limited | ✅ | | **Lead score** + lead signals | ❌ | ✅ 0-100 | | Newly-registered-only / changed-only **monitoring** | ❌ | ✅ | | Export CSV / JSON / Excel / API | ❌ | ✅ | ### Use cases - **Lead generation** — apprenticeship sponsors are employers actively investing in workforce development. Export them with contact, e-mail and phone and feed your CRM or outreach sequence. - **Sell to skilled-trade employers** — tool, equipment, safety, uniform, insurance, benefits, payroll and HR-tech vendors can target sponsors by trade (electrical, plumbing, HVAC, manufacturing, healthcare…) and state. - **Training & EdTech** — related-technical-instruction (RTI) providers, community colleges, LMS and apprenticeship-management platforms can reach sponsors that need curriculum, instruction and software. - **Staffing & recruiting** — find employers and JATCs building their own talent pipelines. - **Grant & workforce consulting** — target newly-registered sponsors for state apprenticeship-expansion grants and tax credits. - **Market & competitive research** — map the Registered Apprenticeship landscape by state, trade and sponsor type. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **US Apprenticeship Sponsor & Employer Leads Scraper**, choose your filters (states, trades, sponsor category, "newly-registered only", "with e-mail only"…), and set **Max results**. 3. Click **Start** and watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "states": ["TX", "CA"], "tradeKeywords": ["electrical", "hvac"], "sponsorCategories": ["employer", "union_jatc"], "withEmailOnly": true, "sortBy": "leadScore", "maxResults": 1000 } ```` - **states** — USPS state/territory codes (e.g. `CA`, `TX`, `PR`). Empty = whole United States. - **sponsorCategories** — `employer`, `union_jatc`, `educational`, `government_workforce`, `association_nonprofit`, `other` (derived from the organization name). - **tradeKeywords** — keep only sponsors whose name or derived trade hints match (e.g. `electrical`, `plumbing`, `hvac`, `healthcare`, `manufacturing`, `welding`, `it`). - **cities / counties / zipCodes / nameQuery** — narrow by location or organization name. - **newlyRegisteredOnly** / **registeredInLastDays** / **registeredAfter** / **registeredBefore** — target by program registration date (the freshest leads). - **withEmailOnly / withPhoneOnly / withContactPersonOnly / withWebsiteOnly / withAnyContactOnly** — keep only contactable records. - **minLeadScore** — keep only records at or above a 0-100 lead score. - **sortBy** — `leadScore` (default), `newestRegistered`, `oldestRegistered`, `name`, `state`, `source`. - **maxResults** — cap the number of records returned. - **monitorMode / monitorKey** — only return sponsors new or changed since the last run with the same key (ideal on a [Schedule](https://docs.apify.com/platform/schedules)). - **includeRawFields** — attach the original source row under `sourceFields`. - **proxyConfiguration** — optional; the source is a public government file and needs no proxy by default. ### Output One clean, dense table — every column applies to every row. A sponsor record: ```json { "recordType": "apprenticeshipSponsor", "organizationName": "Daylight Electric", "sponsorCategory": "employer", "sponsorCategoryLabel": "Employer / Company", "isEmployer": true, "isUnionProgram": false, "trades": ["electrical"], "contactPerson": "Aubrey Day", "email": "info@daylightelectricak.com", "phone": "(907) 317-5287", "website": "http://www.daylightelectricak.com", "street": "3447 East 68th Avenue", "city": "Anchorage", "state": "AK", "stateName": "Alaska", "zip": "99507", "county": "Anchorage Municipality", "fullAddress": "3447 East 68th Avenue, Anchorage, AK, 99507", "registeredDate": "2025-05-27", "registeredYear": 2025, "registeredWithinDays": 391, "isNewlyRegistered": false, "hasEmail": true, "hasPhone": true, "leadScore": 99, "leadSignals": ["Named contact: Aubrey Day", "Registered within last 2 years", "Direct employer sponsor", "Trades: electrical"], "source": "US DOL Office of Apprenticeship — Partner Sponsors", "sourceUrl": "https://www.apprenticeship.gov/sites/default/files/wps/oa_partner_sponsors.csv", "scrapedAt": "2026-06-22T03:47:00.000Z" } ``` #### What to expect (field coverage) This is official government data entered by sponsors, so contact fields are present whenever the sponsor provided them. Verified across the full national file: | Field | Coverage | |---|---| | Organization name, full mailing address, state | ~100% | | Program registration date | 100% | | County | ~76% | | **E-mail** | ~58% | | **Phone** | ~53% | | Named contact person | ~19% | | Website | published only | `sponsorCategory` and `trades` are **derived** from the organization name (best-effort classification) — useful for segmentation; the raw fields are always preserved under `sourceFields` when `includeRawFields` is on. ### Run programmatically ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/apprenticeship-sponsor-leads-scraper').call({ states: ['TX'], tradeKeywords: ['electrical'], withEmailOnly: true, sortBy: 'newestRegistered', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} apprenticeship sponsor leads`); ``` - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch the dataset, manage the actor. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, e-mail sequence) the moment a run finishes. ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new sponsor leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored state gets a new or changed sponsor. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find every newly-registered electrical apprenticeship sponsor in Texas with an e-mail and a lead score above 80" and let it run the scraper for you. ### More scrapers from scrapesage Build a complete **workforce, employer & B2B lead-gen stack**: - **[US Labor Union Leads](https://apify.com/scrapesage/us-labor-union-leads)** — unions & joint apprenticeship trusts from DOL OLMS filings with officers & finances. - **[US Professional License Scraper](https://apify.com/scrapesage/us-professional-license-scraper)** — licensed trades & professionals across multiple state boards. - **[US Contractor License Scraper](https://apify.com/scrapesage/us-contractor-license-scraper)** — licensed construction contractors as leads. - **[US Schools Scraper](https://apify.com/scrapesage/us-schools-scraper)** — K-12 schools, districts & colleges from NCES / IPEDS. - **[US Visa Sponsor Leads](https://apify.com/scrapesage/us-visa-sponsor-leads-scraper)** — employers that sponsor work visas as hiring-intent leads. - **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly-registered companies as fresh leads. - **[Texas Business Leads Scraper](https://apify.com/scrapesage/texas-business-leads-scraper)** — state-scale business prospecting by industry (NAICS). - **[Multi-ATS Job Scraper](https://apify.com/scrapesage/multi-ats-job-scraper)** — live job postings from Greenhouse, Lever, Ashby, SmartRecruiters & Workday. - **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — enrich any domain list with e-mails, phones & socials. ### Tips - **Newly-registered sponsors**: set `newlyRegisteredOnly: true` (or `registeredInLastDays: 180`) and sort by `newestRegistered` to reach employers right after they launch an apprenticeship — the highest-intent window. - **Target a trade**: combine `tradeKeywords: ["electrical"]` with `withEmailOnly: true` for a clean, contactable list of electrical sponsors. - **Employers only**: set `sponsorCategories: ["employer"]` to drop union JATCs, colleges and agencies and focus on direct company accounts. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to capture only sponsors added or changed since the last run — a steady feed of fresh leads. ### FAQ **Where does the data come from?** From the official **U.S. Department of Labor, Office of Apprenticeship "Partner Sponsors"** extract — the same public file that powers the [apprenticeship.gov Partner Finder](https://www.apprenticeship.gov/partner-finder). It lists organizations sponsoring Registered Apprenticeship programs nationwide. **Does it need an API key or login?** No. The source is a single public government CSV — no key, no login, no browser, no proxy required. **How fresh is it?** The file is downloaded live on every run, so you always get the current registry. Run on a [Schedule](https://docs.apify.com/platform/schedules) with monitoring mode to capture newly-registered sponsors as they appear. **Does it include e-mails and phones?** Yes — about 58% of sponsors carry an e-mail and 53% a phone, straight from the federal source. We never fabricate contact data. **What is a Registered Apprenticeship "sponsor"?** A sponsor is the organization responsible for a Registered Apprenticeship program. It can be a single employer, a group of employers, a **union joint apprenticeship & training committee (JATC)**, a college or technical school, a workforce board, or an industry association acting as an intermediary. **What are `sponsorCategory` and `trades`?** They are **derived** from the organization name as a best-effort classification to help you segment the list. The original, unmodified source row is always available under `sourceFields`. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **Is scraping this data legal?** This actor collects publicly available U.S. government data. You're responsible for using it in compliance with applicable laws and the agency's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `states` (type: `array`): Keep only sponsors in these USPS state / territory codes (e.g. CA, TX, NY, PR). Leave empty for the whole United States. The source covers all 50 states, DC, Puerto Rico, Guam and other territories. ## `sponsorCategories` (type: `array`): Keep only these (derived) sponsor categories. 'employer' = direct company sponsor, 'union\_jatc' = union joint apprenticeship & training committee, 'educational' = college / technical school, 'government\_workforce' = government / workforce agency, 'association\_nonprofit' = association / nonprofit intermediary, 'other' = unclassified. ## `tradeKeywords` (type: `array`): Keep only sponsors whose name or derived trade hints match any of these keywords (case-insensitive), e.g. electrical, plumbing, hvac, healthcare, manufacturing, carpentry, welding, it. ## `cities` (type: `array`): Keep only sponsors in these cities (case-insensitive). ## `counties` (type: `array`): Keep only sponsors in these counties (case-insensitive; the word 'County' is optional). ## `zipCodes` (type: `array`): Keep only sponsors in these 5-digit ZIP codes. ## `nameQuery` (type: `string`): Keep only sponsors whose organization name contains this text (case-insensitive). ## `newlyRegisteredOnly` (type: `boolean`): Keep only sponsors whose program was registered within the last 365 days — the freshest workforce-investment buying signal. ## `registeredInLastDays` (type: `integer`): Keep only sponsors registered within this many days. Overrides the 12-month flag when set. ## `registeredAfter` (type: `string`): Keep only sponsors registered on/after this date (YYYY-MM-DD). ## `registeredBefore` (type: `string`): Keep only sponsors registered on/before this date (YYYY-MM-DD). ## `withEmailOnly` (type: `boolean`): Keep only records that have a contact email address. ## `withPhoneOnly` (type: `boolean`): Keep only records that have a phone number. ## `withContactPersonOnly` (type: `boolean`): Keep only records that name a contact person. ## `withWebsiteOnly` (type: `boolean`): Keep only records that have a website URL. ## `withAnyContactOnly` (type: `boolean`): Keep only records that have at least one of email, phone, contact person or website. ## `minLeadScore` (type: `integer`): Keep only records whose derived 0-100 lead score is at least this value. ## `sortBy` (type: `string`): Ordering of the returned records (top N kept by this key). ## `maxResults` (type: `integer`): Maximum number of sponsor records to return. ## `deduplicateResults` (type: `boolean`): Drop duplicate sponsors that share the same name, city, state and ZIP. ## `includeRawFields` (type: `boolean`): Attach the original source row (all 12 columns) under sourceFields on each record. ## `monitorMode` (type: `boolean`): Only return sponsors that are new or whose contact, address or registration date changed since the last run with the same monitor key. Ideal on a Schedule to catch newly-registered apprenticeship sponsors as fresh leads. ## `monitorKey` (type: `string`): Namespace for monitoring mode so independent monitors don't collide. Use a distinct key per saved configuration. ## `proxyConfiguration` (type: `object`): Optional. The source is a public US government file and usually needs no proxy, so leave this off for the fastest run. Enable it only if your network rate-limits the download. ## Actor input object example ```json { "states": [ "TX" ], "newlyRegisteredOnly": false, "withEmailOnly": false, "withPhoneOnly": false, "withContactPersonOnly": false, "withWebsiteOnly": false, "withAnyContactOnly": false, "sortBy": "leadScore", "maxResults": 1000, "deduplicateResults": true, "includeRawFields": true, "monitorMode": false, "monitorKey": "default", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): All apprenticeship sponsor lead records as JSON items in the default dataset. # 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 = { "states": [ "TX" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/apprenticeship-sponsor-leads-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 = { "states": ["TX"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/apprenticeship-sponsor-leads-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 '{ "states": [ "TX" ] }' | apify call scrapesage/apprenticeship-sponsor-leads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/apprenticeship-sponsor-leads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Apprenticeship Sponsor & Employer Leads Scraper", "description": "Scrape 26,000+ US registered apprenticeship program sponsors from official US DOL data: employers, union JATCs, colleges & training providers with contact name, email, phone, address, trade & registration date + lead score. Filter by state, trade, category & new sponsors. B2B leads + monitoring.", "version": "0.1", "x-build-id": "szdzCSBIe8g3bjsCV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~apprenticeship-sponsor-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-apprenticeship-sponsor-leads-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/scrapesage~apprenticeship-sponsor-leads-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-apprenticeship-sponsor-leads-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/scrapesage~apprenticeship-sponsor-leads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-apprenticeship-sponsor-leads-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": { "states": { "title": "States / territories", "type": "array", "description": "Keep only sponsors in these USPS state / territory codes (e.g. CA, TX, NY, PR). Leave empty for the whole United States. The source covers all 50 states, DC, Puerto Rico, Guam and other territories.", "items": { "type": "string" } }, "sponsorCategories": { "title": "Sponsor categories", "type": "array", "description": "Keep only these (derived) sponsor categories. 'employer' = direct company sponsor, 'union_jatc' = union joint apprenticeship & training committee, 'educational' = college / technical school, 'government_workforce' = government / workforce agency, 'association_nonprofit' = association / nonprofit intermediary, 'other' = unclassified.", "items": { "type": "string", "enum": [ "employer", "union_jatc", "educational", "government_workforce", "association_nonprofit", "other" ], "enumTitles": [ "Employer / company", "Union JATC", "College / technical school", "Government / workforce agency", "Association / nonprofit", "Other" ] } }, "tradeKeywords": { "title": "Trade / occupation keywords", "type": "array", "description": "Keep only sponsors whose name or derived trade hints match any of these keywords (case-insensitive), e.g. electrical, plumbing, hvac, healthcare, manufacturing, carpentry, welding, it.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Keep only sponsors in these cities (case-insensitive).", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Keep only sponsors in these counties (case-insensitive; the word 'County' is optional).", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Keep only sponsors in these 5-digit ZIP codes.", "items": { "type": "string" } }, "nameQuery": { "title": "Organization name contains", "type": "string", "description": "Keep only sponsors whose organization name contains this text (case-insensitive)." }, "newlyRegisteredOnly": { "title": "Only newly-registered sponsors (last 12 months)", "type": "boolean", "description": "Keep only sponsors whose program was registered within the last 365 days — the freshest workforce-investment buying signal.", "default": false }, "registeredInLastDays": { "title": "Registered in last N days", "minimum": 1, "type": "integer", "description": "Keep only sponsors registered within this many days. Overrides the 12-month flag when set." }, "registeredAfter": { "title": "Registered after", "type": "string", "description": "Keep only sponsors registered on/after this date (YYYY-MM-DD)." }, "registeredBefore": { "title": "Registered before", "type": "string", "description": "Keep only sponsors registered on/before this date (YYYY-MM-DD)." }, "withEmailOnly": { "title": "Only sponsors with an email", "type": "boolean", "description": "Keep only records that have a contact email address.", "default": false }, "withPhoneOnly": { "title": "Only sponsors with a phone", "type": "boolean", "description": "Keep only records that have a phone number.", "default": false }, "withContactPersonOnly": { "title": "Only sponsors with a named contact", "type": "boolean", "description": "Keep only records that name a contact person.", "default": false }, "withWebsiteOnly": { "title": "Only sponsors with a website", "type": "boolean", "description": "Keep only records that have a website URL.", "default": false }, "withAnyContactOnly": { "title": "Only sponsors with any contact info", "type": "boolean", "description": "Keep only records that have at least one of email, phone, contact person or website.", "default": false }, "minLeadScore": { "title": "Minimum lead score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only records whose derived 0-100 lead score is at least this value." }, "sortBy": { "title": "Sort by", "enum": [ "leadScore", "newestRegistered", "oldestRegistered", "name", "state", "source" ], "type": "string", "description": "Ordering of the returned records (top N kept by this key).", "default": "leadScore" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of sponsor records to return.", "default": 1000 }, "deduplicateResults": { "title": "Deduplicate", "type": "boolean", "description": "Drop duplicate sponsors that share the same name, city, state and ZIP.", "default": true }, "includeRawFields": { "title": "Include raw source fields", "type": "boolean", "description": "Attach the original source row (all 12 columns) under sourceFields on each record.", "default": true }, "monitorMode": { "title": "Monitoring mode (only new / changed)", "type": "boolean", "description": "Only return sponsors that are new or whose contact, address or registration date changed since the last run with the same monitor key. Ideal on a Schedule to catch newly-registered apprenticeship sponsors as fresh leads.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Namespace for monitoring mode so independent monitors don't collide. Use a distinct key per saved configuration.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The source is a public US government file and usually needs no proxy, so leave this off for the fastest run. Enable it only if your network rate-limits the download.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```