# Earth911 — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find recycling centers near you, discover local recycling programs, and learn how to properly recycle specific materials with educational resources. Search by location and material type to get details about nearby facilities and what they accept.

**Category:** Maps & Geospatial | **Website:** [earth911.com/](https://earth911.com/) | **Docs:** [parse.bot/marketplace/fad40ac3-ee46-413d-88ae-e84db7e28bce/earth911-com-api](https://parse.bot/marketplace/fad40ac3-ee46-413d-88ae-e84db7e28bce/earth911-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-earth911-com-api-fad40ac3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_educational_resources

Search for educational articles and guides about recycling and sustainability on Earth911. Returns paginated results with title, URL, and excerpt. Page-based pagination advances through the site's article archive.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | No | Search keyword for articles. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earth911-com-api-fad40ac3/get_educational_resources \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### get_location_details

Get detailed information about a specific recycling center or program by its location_id (obtained from search_recycling_centers results). Returns full list of accepted materials with services, hours, phone, and description.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location_id` | string | Yes | Unique ID of the location or program, from search_recycling_centers results[*].location_id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earth911-com-api-fad40ac3/get_location_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"<string>"}'
```

### search_recycling_centers

Search for recycling centers and programs by material and location. Returns a list of matching centers with address, phone, distance, and a preview of accepted materials. The full result set is returned in one page. Use suggest_materials to discover valid material names before searching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `distance` | integer | No | Search radius in miles. |
| `location` | string | Yes | Zip code or city name to search near (e.g. '10001' or 'New York'). |
| `material` | string | Yes | Material to recycle. Use suggest_materials to discover valid names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earth911-com-api-fad40ac3/search_recycling_centers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"distance":"<integer>","location":"<string>","material":"<string>"}'
```

### suggest_materials

Get autocomplete suggestions for recyclable material names. Returns a list of matching material strings for the given partial query. Use this to discover valid material values before calling search_recycling_centers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial material name to get suggestions for (e.g. 'plas' returns plastic-related materials). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earth911-com-api-fad40ac3/suggest_materials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```