Programmatic access to your leads, search history, and search engine. All endpoints require an API key generated from Settings → API.
Pass your key as a Bearer token in the Authorization header:
Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx| Plan | Daily requests |
|---|---|
| Free | 100 |
| Pro | 1,000 |
| Agency | 10,000 |
When rate limited, the API returns HTTP 429 with a retryAfter timestamp (Unix seconds).
/api/v1/leadsRetrieve your saved leads, paginated newest-first.
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | optional | Page number (default: 1) |
limit | integer | optional | Results per page, max 100 (default: 25) |
curl https://leadzipp.com/api/v1/leads \
-H "Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx"{
"leads": [
{
"id": "uuid",
"name": "Joe's Plumbing",
"address": "123 Main St, Austin TX 78701",
"phone": "+15125551234",
"website": "https://joesplumbing.com",
"rating": 4.7,
"review_count": 83,
"category": "Plumber",
"saved_at": "2026-05-19T12:00:00Z"
}
],
"meta": { "page": 1, "limit": 25, "total": 142, "totalPages": 6 }
}/api/v1/historyRetrieve your past searches, paginated newest-first.
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | optional | Page number (default: 1) |
limit | integer | optional | Results per page, max 100 (default: 25) |
curl https://leadzipp.com/api/v1/history \
-H "Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx"{
"history": [
{
"id": "uuid",
"query": "plumbers",
"location": "Austin, TX",
"results_count": 18,
"created_at": "2026-05-19T11:45:00Z"
}
],
"meta": { "page": 1, "limit": 25, "total": 37, "totalPages": 2 }
}/api/v1/searchRun a new lead search programmatically. Counts against your plan's search quota.
| Name | Type | Required | Description |
|---|---|---|---|
query | string | required | Business type or keyword (e.g. "plumbers") |
location | string | required | City, state, or zip code |
radius | integer | optional | Search radius in miles (default: 10, max: 50) |
curl -X POST https://leadzipp.com/api/v1/search \
-H "Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"query": "plumbers", "location": "Austin, TX", "radius": 15}'{
"results": [
{
"place_id": "ChIJ...",
"name": "Joe's Plumbing",
"address": "123 Main St, Austin TX 78701",
"phone": "+15125551234",
"website": "https://joesplumbing.com",
"rating": 4.7,
"review_count": 83,
"category": "Plumber",
"lat": 30.2672,
"lng": -97.7431
}
],
"count": 18,
"query": "plumbers",
"location": "Austin, TX"
}| Status | Meaning |
|---|---|
401 | Missing or invalid API key |
403 | Account deactivated |
422 | Missing required parameters |
429 | Daily rate limit exceeded — check retryAfter |
500 | Internal server error — try again shortly |
Need help? support@leadzipp.com