# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-feedingamerica-org-api-5d4ee58e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-feedingamerica-org-api-5d4ee58e/get_all_food_banks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_blog_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_blog_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_food_bank_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_hunger_in_america_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_our_work_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_take_action_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/get_ways_to_give \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/search_food_bank_by_zip \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feedingamerica-org-api-5d4ee58e/search_food_banks_by_state \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```