# HarvestPulse Food Hub Finder

> HarvestPulse Food Hub Finder is a paid API for AI agents from harvestpulse.vercel.app, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Finds regional food hubs and farm aggregators that connect local farms to restaurants, schools, and consumers

## Facts

- Endpoint: GET https://harvestpulse.vercel.app/api/harvest/food-hub
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/harvestpulse-food-hub-finder-13a47d2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4dPJhleFU9NgTPhJtt06M

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability harvestpulse-food-hub-finder-13a47d2f
```

Example prompt: Can you find food hubs and regional farm aggregators in the Pacific Northwest that connect local farms to restaurants and schools?

## When to prefer this

Use this endpoint when an agent needs to identify intermediary food hubs or regional farm aggregators rather than individual farms directly. Ideal for restaurant procurement agents, school food service coordinators, or consumers wanting to access local food systems through organized distribution networks rather than direct farm relationships.

## Known failure modes

- No food hubs found for the specified region — returns empty results or not-found message
- Invalid or unrecognized region parameter — returns error response
- Payment not processed — 402 response requiring x402 payment of $0.08 USDC
- Service unavailable or timeout from Vercel hosting — 5xx error

## How this service works

Food hub finder — locate regional food hubs and farm aggregators connecting local farms to restaurants, schools, and consumers near any ZIP via USDA data. For local-food and farm-to-table agents.

## Output

A list of regional food hubs and farm aggregators including their names, geographic coverage, types of buyers they serve (restaurants, schools, consumers), and contact or connection details for sourcing locally grown food.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "zip": {
       "type": "string"
      },
      "lang": {
       "type": "string"
      },
      "radius": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "errors": {
     "type": "object",
     "description": "Documented error responses, keyed by HTTP status code",
     "additionalProperties": {
      "type": "object",
      "required": [
       "description"
      ],
      "properties": {
       "example": {
        "type": "object"
       },
       "description": {
        "type": "string"
       }
      }
     }
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "location": "97201",
  "hubs_found": [
   {
    "name": "Willamette Farm & Food Coalition",
    "phone": "555-010-1234",
    "address": "Eugene, OR",
    "website": "https://example.org",
    "description": "Aggregates and distributes produce from 40+ small farms to regional buyers.",
    "who_they_serve": "restaurants / institutions / consumers / all",
    "how_to_work_with_them": "Contact via website to set up a standing wholesale or consumer order."
   }
  ],
  "search_context": "Live search context on local food infrastructure in this area.",
  "if_no_hub_nearby": "Alternatives for sourcing locally when no hub is nearby — farmers markets, direct farm relationships.",
  "pulse_suggestions": [],
  "what_is_a_food_hub": "A food hub aggregates, distributes, and markets local/regional food, bridging small farms and larger buyers.",
  "who_uses_food_hubs": {
   "consumers": "Some hubs offer consumer-facing online markets for home delivery.",
   "restaurants": "Source locally without managing dozens of individual farm relationships.",
   "schools_hospitals": "Farm-to-school and healthcare sourcing, often USDA-funded."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/harvestpulse-food-hub-finder-13a47d2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from harvestpulse.vercel.app](https://www.zero.xyz/host/harvestpulse.vercel.app/llms.txt)