Developer Reference · REST API v1

Pindrop Developer API

Headless lead intelligence endpoints built for developers, custom scripts, and autonomous LLM agents.

Core REST Endpoints

POST/api/places

Search Google Places API by query string (e.g. 'Roofers in Miami'). Returns ratings, reviews, address, website.

Required Headersx-google-places-api-key
POST/api/discover

End-to-end prospecting pipeline. Queries Places, verifies websites, and scores prospects with 0-100 Fit Scores.

Required Headersx-google-places-api-key, x-gemini-api-key
POST/api/agent/analyze

Headless mobile speed audit (LCP), tech stack detection (WordPress, Shopify, etc.), and monthly revenue leak estimation.

Required HeadersNone (Client-Side Headless)
POST/api/agent/email

AI cold email generation citing specific mobile speed gaps and local market competitors.

Required Headersx-gemini-api-key or x-groq-api-key
POST/api/email/send

Dispatches personalized cold email sequence directly through your verified Resend account with reply tracking.

Required Headersx-resend-api-key

Code Examples

terminal
bash
# 1. Search Google Places Leads in Denver
curl -X POST https://pindrop.lol/api/places \
  -H "Content-Type: application/json" \
  -H "x-google-places-api-key: YOUR_PLACES_KEY" \
  -d '{"query": "Coffee shops in Denver, CO"}'

# 2. Audit Mobile Speed & Revenue Leak
curl -X POST https://pindrop.lol/api/agent/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://hazelandbeancoffee.com"}'

# 3. Generate Personalized Cold Email Cadence
curl -X POST https://pindrop.lol/api/agent/email \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Hazel & Bean Coffee Co.",
    "decisionMakerName": "Marcus Vance",
    "mobileSpeedGap": "4.2s mobile LCP load time"
  }'
Zero-Friction Agent Architecture

How Agents Handle Keys (Even with Zero Setup)

Pindrop is 100% client-side and BYOK (Bring Your Own Key). If you don't have keys configured, your agent will simply prompt you for your free API key in conversation, then execute autonomously without any third-party subscription markup.

You
"Hey ChatGPT, use Pindrop to find 25 dentists in Austin and draft cold outreach for slow sites."
Connecting to Pindrop Lead Engine (/api/discover)...

To query verified Google Places data, pass your Google Places API Key in the chat or enter it in your Pindrop dashboard. Google provides $200 free credit monthly (10,000+ free queries).

Required: Google Places or Tavily Search Key100% Free Tiers