foodpantries.org APIfoodpantries.org ↗
Access food pantry listings across all US states via 7 endpoints. Search by address, browse by state, city, or county, and retrieve full pantry details.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e357eb17-8a49-4462-b671-9274c6c098dd/get_states' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a list of all US states with food pantry listings, including state name, slug, and URL.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of states",
"states": "array of state objects with name, slug, and url"
},
"sample": {
"data": {
"total": 51,
"states": [
{
"url": "https://www.foodpantries.org/st/california",
"name": "California",
"slug": "california"
},
{
"url": "https://www.foodpantries.org/st/texas",
"name": "Texas",
"slug": "texas"
}
]
},
"status": "success"
}
}About the foodpantries.org API
The foodpantries.org API provides access to food pantry listings across the United States through 7 endpoints covering state, city, county, and individual pantry data. The get_pantry_details endpoint returns a pantry's name, address, phone, email, website, operating hours, description, and a Q&A section. You can also search geographically with search_pantries_by_address or browse the directory hierarchy from state down to individual listing.
Directory Browsing
The API exposes a three-level geographic hierarchy. get_states returns all US states that have listings, including each state's name, slug, and url. From a state slug you call get_pantries_by_city with a state_abbr and city_slug to get every pantry in that city, each with name, address, telephone, slug, and detail_url. The parallel endpoint get_pantries_by_county accepts a state_abbr and county_slug (without the _county suffix) and returns the same pantry-level fields organized by county.
Pantry Detail
get_pantry_details takes a pantry_slug from any listing result and returns the full record: structured address with separate street, city, state, and zip fields; phone; email; website; hours; description; and a qa array of question-and-answer pairs that capture additional service details published on the pantry's listing page. Fields like email, website, and hours return an empty string when the pantry has not provided that information.
Address Search and Latest Additions
search_pantries_by_address accepts any combination of address, city, and state (at least one required) and returns a ranked list of matching pantries with name, slug, and detail_url. Results are shallow — use the slug with get_pantry_details to retrieve full contact and hours information. get_latest_additions requires no inputs and returns the most recently added listings from the homepage, each with name, detail_url, slug, and image_url.
- Build a food assistance locator app that resolves a user's street address to nearby pantries using
search_pantries_by_address. - Populate a county-level resource map by iterating
get_pantries_by_countyfor each county in a state. - Display pantry hours and contact info in a social services case management platform via
get_pantry_details. - Track newly listed pantries by polling
get_latest_additionsand pushing updates to a community newsletter. - Generate a city-by-city coverage report by pulling
get_pantries_by_stateand inspecting thecountfield per city. - Feed a nonprofit CRM with verified addresses, phone numbers, and websites pulled from pantry detail records.
- Cross-reference pantry Q&A data from
get_pantry_detailsto surface eligibility requirements for specific client populations.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does foodpantries.org offer an official developer API?+
What does `get_pantry_details` return beyond a basic address?+
get_pantry_details returns the pantry's structured address (with separate street, city, state, and zip fields), phone, email, website, hours, a free-text description, and a qa array of question-and-answer pairs that capture additional service or eligibility details. Fields with no data are returned as empty strings rather than null.Are pantry operating hours and eligibility requirements always available?+
hours and email fields return an empty string when the source listing omits that information, and the qa array may be empty for pantries with minimal published details. Coverage depends on what each pantry has submitted to foodpantries.org.Does the API support filtering pantries by service type, language, or dietary restrictions?+
Does `search_pantries_by_address` return full pantry details in its response?+
name, slug, and detail_url per pantry. To retrieve address, phone, hours, and other fields you need to pass each result's slug to get_pantry_details. You can fork this API on Parse and revise it to chain that lookup automatically if you need enriched search results in a single call.