# PestWorld (NPMA) Pest Control Directory Scraper (`crawlerbros/pestworld-pest-control-directory-scraper`) Actor Find licensed, NPMA-member pest control and exterminator companies near any US ZIP code, Canadian postal code, or country. Get company name, address, phone, website, and QualityPro certification status from PestWorld.org's official Find-a-Pro locator. - **URL**: https://apify.com/crawlerbros/pestworld-pest-control-directory-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Developer tools - **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 ## PestWorld (NPMA) Pest Control Directory Scraper Find licensed, NPMA-member pest control companies and exterminators near any US ZIP code, Canadian postal code, or browse every member company in a given country. Scrapes PestWorld.org's official "Find a Pro" locator, run by the **National Pest Management Association (NPMA)**. No login, no API key. ### What this actor does - **Two search modes:** `byZipCode` (local search around a US ZIP or Canadian postal code) and `byCountry` (all NPMA member companies in a given country) - **Company details:** name, full address, phone, website (when listed) - **QualityPro certification flag** — NPMA's industry-leading credentialing program - **Filters:** QualityPro-certified only, website-required only - **Empty fields are omitted** — every record only contains data actually shown on the source page ### Output per company - `companyName` - `streetAddress`, `city`, `state`, `postalCode`, `fullAddress` - `phone` — normalized international format. US/Canada and other NANP countries (e.g. Jamaica, Bahamas) use the familiar `+1 (xxx) xxx-xxxx` grouping; every other `byCountry` search uses that country's own ITU calling code instead, e.g. `+49 8857697040` for Germany or `+61 754491765` for Australia. Omitted (not fabricated) when the source listing's phone number can't be reliably parsed for the searched country - `website` — when the listing includes one - `qualityProCertified` — `true`/`false` - `npmaMember` — always `true` (every listed pro is vetted by NPMA) - `listingType` — `sponsored` (featured/QualityPro spotlight cards) or `standard` (full directory listing) - `searchZipCode` / `searchCountry` — echoes the search input used - `sourceUrl` — the PestWorld locator page scraped - `recordType: "pestControlCompany"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byZipCode` | `byZipCode` / `byCountry` | | `zipCode` | string | `90210` | US ZIP or Canadian postal code (mode=byZipCode) | | `country` | string | `Canada` | Country to browse (mode=byCountry) — 162 countries supported | | `qualityProCertifiedOnly` | bool | `false` | Only return QualityPro-certified companies | | `requireWebsite` | bool | `false` | Only return companies with a website listed | | `maxItems` | int | `30` | Hard cap on emitted records (1–1000) | #### Example: local search by ZIP code ```json { "mode": "byZipCode", "zipCode": "10001", "maxItems": 20 } ```` #### Example: QualityPro-certified only near a ZIP code ```json { "mode": "byZipCode", "zipCode": "90210", "qualityProCertifiedOnly": true } ``` #### Example: all NPMA members in a country ```json { "mode": "byCountry", "country": "Australia", "maxItems": 100 } ``` ### Use cases - **Homeowners / property managers** — find a vetted, NPMA-member exterminator near you - **Lead generation** — build a list of licensed pest control companies by territory - **Market research** — measure pest-control company density and QualityPro certification rates by region - **Franchise / competitive analysis** — track which national brands (Orkin, Terminix, etc.) operate in a market - **Directory aggregation** — enrich local-business datasets with NPMA-verified pest control listings ### FAQ **What is NPMA / PestWorld.org?** The National Pest Management Association is the pest control industry's trade association. PestWorld.org is its consumer-facing site, and the Find-a-Pro locator lists dues-paying NPMA member companies. **What's QualityPro certification?** NPMA's voluntary credentialing program. QualityPro companies undergo background checks, ongoing training, and drug-free workplace audits. See [qualitypro.org](https://www.qualitypro.org/). **Does this include every pest control company in the US?** No — only NPMA member companies. Many national and regional companies are members, but independent/non-member exterminators won't appear. **Why do some companies lack a website?** PestWorld only publishes a website link when the member company supplied one; many smaller local companies list phone-only contact. **Are all `website` links guaranteed to work?** The actor relays the URL exactly as published on PestWorld's listing. Occasionally a member company's self-reported website has since moved or gone offline (this is upstream data staleness, not something the actor can detect or fix) — the vast majority resolve correctly. **Can I search by pest type or service type (residential/commercial)?** The upstream locator only supports ZIP/postal code and country search — it has no pest-type or service-type filter, so this actor doesn't expose one either (to avoid inventing filters the source doesn't support). **How many results come back per ZIP code?** Typically 0–15+ depending on local NPMA membership density; sparse rural ZIPs may return few or zero results, which is real data, not a scraping error. **Is Canada supported?** Yes — Canadian postal codes work in `byZipCode` mode (e.g. `M5H 2N2`), and `Canada` is also selectable in `byCountry` mode for a nationwide member listing. **Why does `byCountry` for a large country (e.g. United States) return fewer records than `maxItems`?** PestWorld's Find-a-Pro locator serves the entire country listing as a single, non-paginated results page — there is no "next page" to follow. For very large member countries this page itself is capped by PestWorld at roughly 500 companies; the actor already extracts every company card present, so raising `maxItems` beyond that won't yield more records. This is an upstream source limit, not an actor shortfall. # Actor input Schema ## `mode` (type: `string`): How to search PestWorld's Find-a-Pro locator. ## `zipCode` (type: `string`): A 5-digit US ZIP code (e.g. `90210`) or Canadian postal code (e.g. `M5H 2N2`). Required for mode=byZipCode. ## `country` (type: `string`): Country to browse all NPMA member companies in. Required for mode=byCountry. ## `qualityProCertifiedOnly` (type: `boolean`): Only return companies that hold NPMA's QualityPro certification. ## `requireWebsite` (type: `boolean`): Only return companies that have a website listed. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byZipCode", "zipCode": "90210", "country": "Canada", "qualityProCertifiedOnly": false, "requireWebsite": false, "maxItems": 30 } ``` # Actor output Schema ## `companies` (type: `string`): Dataset containing all scraped pest control companies. # 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": "byZipCode", "zipCode": "90210", "country": "Canada", "qualityProCertifiedOnly": false, "requireWebsite": false, "maxItems": 30 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/pestworld-pest-control-directory-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": "byZipCode", "zipCode": "90210", "country": "Canada", "qualityProCertifiedOnly": False, "requireWebsite": False, "maxItems": 30, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/pestworld-pest-control-directory-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": "byZipCode", "zipCode": "90210", "country": "Canada", "qualityProCertifiedOnly": false, "requireWebsite": false, "maxItems": 30 }' | apify call crawlerbros/pestworld-pest-control-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/pestworld-pest-control-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PestWorld (NPMA) Pest Control Directory Scraper", "description": "Find licensed, NPMA-member pest control and exterminator companies near any US ZIP code, Canadian postal code, or country. Get company name, address, phone, website, and QualityPro certification status from PestWorld.org's official Find-a-Pro locator.", "version": "1.0", "x-build-id": "Dj78gm5zgPFPL0kC3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~pestworld-pest-control-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-pestworld-pest-control-directory-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~pestworld-pest-control-directory-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-pestworld-pest-control-directory-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~pestworld-pest-control-directory-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-pestworld-pest-control-directory-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": "Search mode", "enum": [ "byZipCode", "byCountry" ], "type": "string", "description": "How to search PestWorld's Find-a-Pro locator.", "default": "byZipCode" }, "zipCode": { "title": "ZIP / postal code", "type": "string", "description": "A 5-digit US ZIP code (e.g. `90210`) or Canadian postal code (e.g. `M5H 2N2`). Required for mode=byZipCode.", "default": "90210" }, "country": { "title": "Country", "enum": [ "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Argentina", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belgium", "Bermuda", "Bolivia", "Botswana", "Brazil", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cayman Islands", "Chile", "China", "Colombia", "Congo", "Congo, The Democratic Republic Of The", "Costa Rica", "Cote D'Ivoire", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Ethiopia", "Fiji", "Finland", "France", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guam", "Guatemala", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic Of", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Korea, Republic Of", "Kuwait", "Latvia", "Lebanon", "Liberia", "Libyan Arab Jamahiriya", "Lithuania", "Luxembourg", "Madagascar", "Malawi", "Malaysia", "Maldives", "Malta", "Marshall Islands", "Mauritius", "Mayotte", "Mexico", "Mongolia", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "Netherlands Antilles", "New Zealand", "Nicaragua", "Nigeria", "Norway", "Oman", "Pakistan", "Palestine, State of", "Palestinian Territory, Occupied", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russian Federation", "Rwanda", "Saint Kitts And Nevis", "Saint Lucia", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "Spain", "Sri Lanka", "Sudan", "Suriname", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan", "Tanzania, United Republic Of", "Thailand", "Togo", "Trinidad And Tobago", "Tunisia", "Turkey", "Turks And Caicos Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Venezuela", "Viet Nam", "Virgin Islands, U.S.", "Yemen", "Zambia", "Zimbabwe" ], "type": "string", "description": "Country to browse all NPMA member companies in. Required for mode=byCountry.", "default": "Canada" }, "qualityProCertifiedOnly": { "title": "QualityPro certified only", "type": "boolean", "description": "Only return companies that hold NPMA's QualityPro certification.", "default": false }, "requireWebsite": { "title": "Require website", "type": "boolean", "description": "Only return companies that have a website listed.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "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 } } } } } } } } } } ```