# Dumpsters.com Rental Locator Scraper (`crawlerbros/dumpsters-com-rental-locator-scraper`) Actor

Scrape dumpster rental pricing and availability from dumpsters.com by city/state, dumpster size (10-40 yard), or waste/project type. No login or proxy required.

- **URL**: https://apify.com/crawlerbros/dumpsters-com-rental-locator-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, E-commerce, 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/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Dumpsters.com Rental Locator Scraper

Find dumpster rental pricing, availability, and specs from **dumpsters.com** — a nationwide roll-off dumpster rental service. Look up pricing by city or state, compare dumpster sizes (10-40 yard), or browse rental options by waste/project type (construction debris, household junk, yard waste, concrete, and more). No login, no proxy, no cost to run.

Ideal for construction and renovation companies, junk-removal businesses, and homeowners comparing dumpster rental options and researching typical pricing in their area.

### What this actor does

- **Pricing by location** — low/high/average rental price for any of 300 US cities & counties dumpsters.com serves (46 states + DC)
- **Statewide coverage** — pull pricing for every location dumpsters.com serves in a given state
- **Size specs** — dimensions (height/width/depth), volume in cubic yards, description, image, nationwide price range, and typical renter type for each of the 6 standard roll-off sizes (10, 12, 15, 20, 30, 40 yard)
- **Waste/project type info** — service details, quote links, typical customer type, and related services for 11 waste and project categories (construction, residential, concrete, roofing, yard waste, industrial, demolition, dirt, solar, contractor, and event waste)
- Empty fields are always omitted — every returned field has real, current data from dumpsters.com

### Modes

| Mode | What it returns |
|---|---|
| `byCity` | Pricing + available sizes for one location (default) |
| `byState` | Pricing + available sizes for every location dumpsters.com serves in a state |
| `bySize` | Dimensions/specs for one dumpster size, or all 6 if none specified |
| `byWasteType` | Service info for one waste/project type, or all 11 if none specified |

### Output fields

#### `byCity` / `byState` (`recordType: "cityPricing"`)

- `locationSlug`, `cityLabel`, `stateCode`, `stateName`
- `serviceName`, `description`
- `lowPrice`, `highPrice`, `averagePrice`, `currency`
- `availableSizes[]` — `{ sizeYards, name, description, volumeCubicYards, url }` for each size offered at this location
- `pricingIncludes` — what's bundled into the quoted price
- `sourceUrl`, `scrapedAt`

#### `bySize` (`recordType: "dumpsterSize"`)

- `sizeYards`, `name`, `description`, `imageUrl`
- `dimensions` — `{ height, width, depth }`
- `nationalLowPrice`, `nationalHighPrice`, `currency`, `inStock` — nationwide price range for this size across all dumpsters.com service areas
- `audienceTypes[]` — `{ name, url }` typical renters for this size (e.g. Homeowners, Contractors)
- `relatedSizes[]` — `{ sizeYards, name, url }`
- `sourceUrl`, `scrapedAt`

#### `byWasteType` (`recordType: "wasteTypeService"`)

- `wasteTypeSlug`, `wasteTypeLabel`, `name`, `serviceType`, `description`, `imageUrl`
- `serviceArea`, `quoteUrl`, `phone`
- `audienceTypes[]` — `{ name, url }` typical customers for this waste/project type (e.g. Roofing Contractors, Landscapers)
- `similarServices[]` — `{ name, url }`
- `sourceUrl`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | select | `byCity` | `byCity` / `byState` / `bySize` / `byWasteType` |
| `locationSlug` | select | `chicago-il` | Location for `byCity` (300 options) |
| `state` | select | – | US state for `byState` (46 states + DC dumpsters.com serves) |
| `size` | select | – | Dumpster size in yards for `bySize` (blank = all 6) |
| `wasteType` | select | – | Waste/project type for `byWasteType` (blank = all 11) |
| `minPrice` | integer | – | Drop locations priced below this (USD) |
| `maxPrice` | integer | – | Drop locations priced above this (USD) |
| `maxItems` | integer | `20` | Cap on emitted records for `byState`/`bySize`/`byWasteType` |

#### Example: all dumpster pricing in Texas under $1000

```json
{
  "mode": "byState",
  "state": "tx",
  "maxPrice": 1000,
  "maxItems": 50
}
```

Note: `maxPrice` filters on the location's *high end* of its advertised price
range (the cost of its biggest available dumpster), so it only matches
locations where every size is affordable within budget -- not just the
cheapest size. Use a higher `maxPrice` if you only care about the low end.

#### Example: specs for every dumpster size

```json
{
  "mode": "bySize",
  "maxItems": 10
}
```

#### Example: dumpster options for a roofing project

```json
{
  "mode": "byWasteType",
  "wasteType": "roofing-dumpster"
}
```

### Use cases

- **Construction & renovation companies** — compare dumpster rental pricing across multiple job-site cities before bidding a project
- **Junk-removal businesses** — research local competitor pricing and available sizes by market
- **Homeowners** — figure out what size dumpster fits a home cleanout, renovation, or yard-waste job and what it typically costs
- **Roofing & demolition contractors** — find waste-type-specific service details (roofing debris, demolition debris) and typical customer type
- **Real-estate & property managers** — budget dumpster costs across a multi-state portfolio using `byState`

### FAQ

**Does this need a login or API key?** No — all data comes from dumpsters.com's public pages.

**Which locations are covered?** 300 cities/counties across 46 states + Washington DC. dumpsters.com's sitemap lists 364 service-area pages total, but 64 of them (43 individual cities plus all 21 New Jersey county-level rollup pages) render no pricing data on the live page at all — those are excluded so every location option in this actor reliably returns a record. Alaska, Hawaii, Idaho, Montana, and Wyoming are not currently served by dumpsters.com and are not listed.

**Why only 6 dumpster sizes?** dumpsters.com publishes full dimension specs only for its standard roll-off sizes (10-40 yard). Smaller bag/mini-container options don't have published structured specs on the site.

**Is zip-code lookup supported?** Not currently — dumpsters.com's zip-based quote tool requires an interactive session. City/county/state lookup covers the same public pricing data reliably.

### Data source

All data is read from dumpsters.com's own [schema.org](https://schema.org) structured data (JSON-LD `Service`/`Product` blocks) embedded in its public pages — the same structured data Google uses for search snippets. No account, cookies, or paid proxy required.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `locationSlug` (type: `string`):

A dumpsters.com service-area location.

## `state` (type: `string`):

US state to list all dumpsters.com service-area locations in.

## `size` (type: `string`):

Roll-off dumpster size. Leave blank to fetch specs for all 6 sizes.

## `wasteType` (type: `string`):

Waste or project type. Leave blank to fetch service info for all types.

## `minPrice` (type: `integer`):

Drop locations whose low-end price is below this (mode=byCity/byState).

## `maxPrice` (type: `integer`):

Drop locations whose high-end price is above this (mode=byCity/byState).

## `maxItems` (type: `integer`):

Hard cap on emitted records (mode=byState/bySize/byWasteType).

## Actor input object example

```json
{
  "mode": "byCity",
  "locationSlug": "chicago-il",
  "maxItems": 20
}
```

# Actor output Schema

## `rentals` (type: `string`):

Dataset containing all scraped pricing, size, and service-type records.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "byCity",
    "locationSlug": "chicago-il",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/dumpsters-com-rental-locator-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "byCity",
    "locationSlug": "chicago-il",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/dumpsters-com-rental-locator-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": "byCity",
  "locationSlug": "chicago-il",
  "maxItems": 20
}' |
apify call crawlerbros/dumpsters-com-rental-locator-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlerbros/dumpsters-com-rental-locator-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xb9M9nGBWI1Cmk4tP/builds/E3iqJC4cweKlsEOk8/openapi.json
