# HarvestPulse Food Hub Finder

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

Locates regional food hubs and farm aggregators connecting local farms to restaurants, schools, and consumers near a given ZIP code using USDA data

## Facts

- Endpoint: GET https://harvestpulse.theaslangroupllc.com/api/harvest/food-hub
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/harvestpulse-food-hub-finder-c359d891
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xDMaFhYPN5ySnXfdjRiFM

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-c359d891
```

Example prompt: Can you find food hubs and farm aggregators near ZIP code 80203 in Denver — I'm looking for regional distribution hubs that connect local farms to restaurants and schools?

## When to prefer this

Use this endpoint when an agent needs to locate food hubs or farm aggregator networks tied to a specific geographic area using authoritative USDA data, especially for farm-to-table sourcing, institutional food procurement, or local food system research. Prefer this over generic directory searches when ZIP-based proximity and USDA-verified data are required.

## Known failure modes

- No food hubs found for the given ZIP code or region — sparse USDA coverage in rural areas
- Invalid or non-existent ZIP code returns an error
- ZIP code provided is outside the US, which is unsupported
- USDA data source temporarily unavailable causing timeout or 503
- Rate limiting or payment failure via x402 protocol returning 402

## 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 near the specified ZIP code, sourced from USDA data, including hub names, service areas, types of buyers served (restaurants, schools, consumers), and likely contact or location details.

## 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-c359d891/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from harvestpulse.theaslangroupllc.com](https://www.zero.xyz/host/harvestpulse.theaslangroupllc.com/llms.txt)