Reference · Business search

Find businesses in an area, with emails

POST /api/v1/search

Finds businesses of one kind in a place (for example dentists in Austin, TX) and the best email for each: the business email or the owner's, checked. It runs in rounds until it has target emails that work (or searched the whole area). Poll GET /api/v1/lists/{listId} or set webhookUrl (event search.completed).

Owner emails: only owners the business names on its own website. For businesses in Vermont, Oregon and Connecticut we deliver owner emails only when the website prints them.

Credits: 1 credit per delivered email that Works. Businesses without a website, and emails we could not confirm, are free. With brief: true, plus 0.5 credits per summary.

Body (JSON)

Example request

curl -X POST "https://moleman.io/api/v1/search" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"category":"dentist","location":"Austin, TX","country":"US","target":25}'

Example answer

{
  "runId": 55,
  "listId": 380,
  "jobId": 984,
  "livemode": true,
  "run": {
    "status": "running",
    "delivered": 0,
    "creditsUsed": 0
  },
  "pollUrl": "/api/v1/lists/380"
}

Errors