# Pontor Contact Harvest

> Pontor Contact Harvest is a paid API for AI agents from www.pontor.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-15).

Discovers and returns public business names, contact details, websites, phones, and emails for a given local service category and location by scraping search and business directories.

## Facts

- Endpoint: POST https://www.pontor.io/api/x402/contact-harvest
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pontor-contact-harvest-f587eb23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uRAt4_ZWOenomQBFZRRTC

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 pontor-contact-harvest-f587eb23 -d '<json body>'
```

Example prompt: Can you find me up to 20 local commercial cleaning services in Chicago, Illinois — pull their business names, phone numbers, emails, and websites from public directories so I can build an outreach list for my office facilities team?

## When to prefer this

Choose this endpoint when you need to quickly build a list of local service vendors or contacts for research or outreach without manually scraping directories. It is best suited for operational service categories (e.g. cleaning, HVAC, plumbing, landscaping) in a specific city or region. Prefer this over general web search when you want structured, ready-to-use contact records with source evidence. Not suitable for contacting anyone directly — it only retrieves and organizes public data.

## Known failure modes

- No contacts found for obscure service categories or rural locations — returns empty contact list with warnings
- Rate limiting or payment failure returns an error before any results are delivered
- Truncated results if max_contacts limit is reached before full directory coverage
- Stale cached results returned for recently queried service/location pairs
- Invalid or unreachable directory_urls provided cause those sources to be skipped silently
- Malformed location query may result in no location match and empty results

## How this service works

Harvest public business and contact information for a local service category and location. Given a service, location, and optional known directory URLs, return public business names, contact names, websites, phones, emails, and contact URLs discovered from search and business directories, each with source evidence. Suitable for building outreach or research lists for local operational services. Research only: does not contact anyone, send messages, or act on returned contacts.

## Output

Returns a structured list of contact records, each containing public business name, contact name, website URL, phone number, email address, and source URL with evidence. Also includes metadata such as request ID, result set ID, cache status, normalized service slug and location, provider status, and any warnings about result quality or coverage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "max_contacts": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of contact records to return."
  },
  "buyer_context": {
   "type": "string",
   "maxLength": 160,
   "minLength": 1,
   "description": "Business or facility context that improves relevance."
  },
  "service_query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1,
   "description": "Local operational service or professional category to source contacts for. One category per request."
  },
  "directory_urls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "Optional URLs of directory or list pages the agent already knows are relevant. Not required — Pontor discovers directories on its own."
  },
  "location_query": {
   "type": "string",
   "maxLength": 160,
   "minLength": 1,
   "description": "City, region, or address to find contacts in."
  },
  "location_latitude": {
   "type": "number",
   "description": "Latitude for the requested location when the agent has reliable coordinates. Expected range: -90 to 90."
  },
  "location_longitude": {
   "type": "number",
   "description": "Longitude for the requested location when the agent has reliable coordinates. Expected range: -180 to 180."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pontor-contact-harvest-f587eb23/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.pontor.io](https://www.zero.xyz/host/www.pontor.io/llms.txt)