Developer docs
Leads Puller API documentation
Leads Puller is a lead generation suite for teams that need structured business exports from Google Maps, Google Search, Yellow Pages directories, and Domain email discovery on public websites. Use the REST API to search people and companies programmatically, manage credits, and integrate with your outbound stack.
REST APIOpenAPIAPI keys
Authentication
OpenAPI spec: https://api.leadspuller.com/api/v1/openapi.json
# Leads Puller API — Authentication
Base URL: https://api.leadspuller.com/api/v1
## API key auth (search endpoints)
Pass your API key on every search request using either:
```
X-API-Key: lp_live_YOUR_SECRET
```
or
```
Authorization: Bearer lp_live_YOUR_SECRET
```
Create and manage keys in the dashboard at /user/dashboard/api (session JWT). Secrets are shown only once at create/regenerate.
## Key management (dashboard JWT)
Use the logged-in user's Bearer JWT (not the API key):
- GET https://api.leadspuller.com/api/v1/keys
- POST https://api.leadspuller.com/api/v1/keys body: { "name": "Production" }
- PATCH https://api.leadspuller.com/api/v1/keys/:id body: { "name": "New name" }
- POST https://api.leadspuller.com/api/v1/keys/:id/regenerate
- DELETE https://api.leadspuller.com/api/v1/keys/:id
OpenAPI: https://api.leadspuller.com/api/v1/openapi.json
Need live keys and usage tracking? Create an account and open the developer portal.
Pass your API key via the X-API-Key header or Authorization Bearer token on search endpoints. Keys are created in the developer dashboard after registration.
Start finding qualified leads today
Free trial, verified public-source data, and structured exports—no credit card required.