Leads Puller API documentation

Authentication

OpenAPI spec: https://api.leadspuller.com/api/v1/openapi.json

# Leads Puller API — Authentication

Leads Puller provides a REST API for local business lead generation: people and company search, email and phone lookup, and CRM enrichment. Authenticate search endpoints with API keys created in your dashboard.

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.