# AgentBodega Volunteer Opportunity Search

> AgentBodega Volunteer Opportunity Search is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches a database of volunteer opportunities by keyword, location, category, or URL, returning paginated listings with organization and location details.

## Facts

- Endpoint: POST https://agentbodega.store/api/public-data/volunteer-opportunity-search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbodega-volunteer-opportunity-search-46925564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E2RJRgLGJdP97TKy3_6fK

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 agentbodega-volunteer-opportunity-search-46925564 -d '<json body>'
```

Example prompt: Can you find me volunteer opportunities near Brooklyn, NY within 15 miles focused on food assistance? I'm open to in-person only, show me the first 10 results.

## When to prefer this

Choose this endpoint when an agent needs to help a user discover or browse volunteer opportunities by keyword, geography (lat/lon + radius), category, or a known opportunity URL. It's well-suited for civic-engagement agents, community-service recommendation flows, or any workflow where a human wants to find ways to give back locally or remotely. Prefer this over general web search when structured, filterable volunteer data is needed.

## Known failure modes

- No results found for the given query or location (empty results array with total: 0)
- Invalid coordinates cause lookup failure
- Malformed opportunityUrl returns no match
- Page/limit parameters out of range returning empty results
- Payment failure via x402 protocol preventing request from completing

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

A JSON object containing a success flag, total count of matching opportunities, and a paginated array of results — each with an ID, title, remote status, city/state location, and organization name. Also includes tool metadata (id, name, department).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "query",
       "type": "string",
       "required": false
      },
      {
       "name": "opportunityUrl",
       "type": "string",
       "required": false
      },
      {
       "name": "lat",
       "type": "number",
       "required": false
      },
      {
       "name": "lon",
       "type": "number",
       "required": false
      },
      {
       "name": "radiusMiles",
       "type": "number",
       "required": false
      },
      {
       "name": "remote",
       "type": "boolean",
       "required": false
      },
      {
       "name": "categories",
       "type": "array",
       "required": false
      },
      {
       "name": "page",
       "type": "integer",
       "required": false
      },
      {
       "name": "limit",
       "type": "integer",
       "required": false
      },
      {
       "name": "proxiesSx",
       "type": "boolean | object",
       "required": false
      }
     ],
     "required": [],
     "fieldCount": 10,
     "contentType": "application/json",
     "optionalPreview": [
      "query",
      "opportunityUrl",
      "lat",
      "lon",
      "radiusMiles",
      "remote",
      "categories",
      "page",
      "limit",
      "proxiesSx"
     ],
     "omittedFieldCount": 0
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "volunteer-opportunity-search",
   "name": "Volunteer Opportunity Search",
   "department": "Public Data"
  },
  "total": 128,
  "results": [
   {
    "id": "abc123",
    "title": "Pack meals for neighbors",
    "remote": false,
    "location": {
     "city": "New York",
     "state": "NY"
    },
    "organization": "Example Food Bank"
   }
  ],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentbodega-volunteer-opportunity-search-46925564/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)