# Feedingamerica — 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 nearby food banks by ZIP code or state, view detailed organizational profiles and leadership information, and access hunger statistics and news about food insecurity across the nation. Discover ways to take action and support local food banks through giving options and impact metrics.

**Category:** Government & Public Data | **Website:** [feedingamerica.org/](https://feedingamerica.org/) | **Docs:** [parse.bot/marketplace/5d4ee58e-0f17-4eae-953f-d6b940eec137/feedingamerica-org-api](https://parse.bot/marketplace/5d4ee58e-0f17-4eae-953f-d6b940eec137/feedingamerica-org-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all food banks

Retrieve the complete list of all Feeding America partner food banks. Returns each bank's name, slug, address, city, state, ZIP, phone number, website URL, profile URL, and counties served. Single-page endpoint returning all ~200 food banks in one response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-all-food-banks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get blog article detail

Retrieve the full content of a specific Hunger Blog article by its slug. Returns the article title and full body text. The slug is the last path segment of the url field from get_blog_articles results. The hunger-blog/ prefix is automatically prepended if not present.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The article slug, with or without the 'hunger-blog/' prefix (e.g. 'getting-food-neighbors-proud-moment-every-day'). Obtainable from the url field in get_blog_articles results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-blog-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get blog articles

Retrieve a paginated list of articles from the Feeding America Hunger Blog. Each article includes title, URL, publication date, and summary. Page 0 is the first page. Returns approximately 10 articles per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-blog-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get food bank details

Retrieve full profile details for a specific food bank by its slug. Returns name, address, phone, website, leadership contacts, social links, impact metrics (meals provided, pounds distributed), counties served, and regional hunger statistics. The slug is the last path segment of the profile_url returned by search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique slug identifying a food bank (e.g. greater-chicago-food-depository). Obtainable from the slug field in search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-food-bank-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get hunger in america overview

Retrieve content from the Hunger in America section covering national hunger statistics and facts. Returns the page title and full text content including statistics, causes of hunger, and impact metrics.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-hunger-in-america-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get our work overview

Retrieve content from the Our Work section describing Feeding America's programs. Returns page title and full text content covering food access, food rescue, disaster response, and hunger research initiatives.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-our-work-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get take action options

Retrieve content from the Take Action section listing ways users can get involved with Feeding America. Returns page title and full text content including volunteering, food drives, and community engagement options.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-take-action-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ways to give

Retrieve donation and giving options from the Ways to Give section. Returns page title and full text content covering one-time gifts, monthly donations, corporate partnerships, food donation, and other ways to support Feeding America.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/get-ways-to-give \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search food bank by zip

Find the nearest Feeding America food bank(s) for a given ZIP code. Returns matching food banks with name, slug, profile URL, and website. Uses the upstream organization-by-ZIP lookup and enriches results from the full organizations dataset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip` | string | Yes | 5-digit US ZIP code (e.g. 60601, 02134). Leading zeros preserved. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/search-food-bank-by-zip \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"zip":"<string>"}'
```

### Search food banks by state

Find Feeding America food banks in a given US state. Returns matching food banks with name, slug, and profile URL. Queries by 2-letter state abbreviation and enriches results from the full organizations dataset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | Yes | 2-letter US state abbreviation. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feedingamerica/search-food-banks-by-state \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.