# Foodpantries — 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 food pantries near you by searching your address, browsing by state, city, or county, and access detailed information about locations and services. Discover newly added pantries and explore comprehensive listings to locate food assistance resources in your area.

**Category:** Government & Public Data | **Website:** [foodpantries.org/](https://foodpantries.org/) | **Docs:** [parse.bot/marketplace/72ae5001-4817-4c91-874e-c0bf35008e07/foodpantries-org-api](https://parse.bot/marketplace/72ae5001-4817-4c91-874e-c0bf35008e07/foodpantries-org-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-foodpantries-org-api-72ae5001/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_latest_additions

Returns the most recently added food pantry listings from the homepage. Each item includes pantry name, detail URL, slug, and optional image URL. Useful for discovering new pantries without knowing a specific location.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_latest_additions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_pantries_by_city

Returns all food pantry listings in a specific city. Each pantry includes name, structured address, telephone number, slug, and detail URL. Use the pantry slug with get_pantry_details for full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug as returned by get_pantries_by_state (e.g., 'anaheim', 'los_angeles', 'houston'). |
| `state_abbr` | string | Yes | Two-letter state abbreviation in lowercase (e.g., 'ca', 'tx', 'ny'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_pantries_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","state_abbr":"<string>"}'
```

### get_pantries_by_county

Returns all food pantry listings in a specific county. Each pantry includes name, structured address, telephone number, slug, and detail URL. Use the pantry slug with get_pantry_details for full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `county_slug` | string | Yes | County slug without '_county' suffix (e.g., 'orange', 'harris', 'los_angeles'). |
| `state_abbr` | string | Yes | Two-letter state abbreviation in lowercase (e.g., 'ca', 'tx', 'ny'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_pantries_by_county \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"county_slug":"<string>","state_abbr":"<string>"}'
```

### get_pantries_by_state

Lists all cities within a given state that have food pantry listings. Each city includes its name, pantry count, slug, two-letter state abbreviation, and URL. Use state_abbr and city slug with get_pantries_by_city to list pantries in that city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state_slug` | string | Yes | State slug as used in the URL path (e.g., 'california', 'new_york', 'texas'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_pantries_by_state \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state_slug":"<string>"}'
```

### get_pantry_details

Returns full details for a single food pantry, including name, structured address, phone, email, website, operating hours, description text, and a Q&A section. The pantry_slug is obtained from listing endpoints like get_pantries_by_city or search_pantries_by_address.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pantry_slug` | string | Yes | Pantry slug from listing results (e.g., 'ca_92833_mariners-church-anaheim', 'salvation_army_92801'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_pantry_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pantry_slug":"<string>"}'
```

### get_states

Returns all US states that have food pantry listings. Each state includes its display name, URL slug for further drilling, and full URL. Use state slugs with get_pantries_by_state to list cities within a state.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/get_states \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_pantries_by_address

Search for food pantries near a given location. Submits address, city, and/or state to the site's search form and returns matching pantries. At least one of address, city, or state must be provided. Results include pantry name, detail URL, and slug for use with get_pantry_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Street address (e.g., '123 Main St'). |
| `city` | string | No | City name (e.g., 'Los Angeles', 'Houston', 'Chicago'). |
| `state` | string | No | State name or two-letter abbreviation (e.g., 'California', 'CA', 'TX'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-foodpantries-org-api-72ae5001/search_pantries_by_address \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","city":"<string>","state":"<string>"}'
```