Back to home
LeadZipp API
v1Agency programmatic access to your leads, search history, and search engine. All endpoints require an API key generated from Settings → API.
Keep your API key secret. It grants full access to your account data.
Pass your key as a Bearer token in the Authorization header:
Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx| Plan | Access |
|---|---|
| Free | Not included |
| Pro | Not included |
| Agency | 500 requests/day |
Live search cache misses also share the Agency workspace's 300-search monthly allowance. Cached API search responses consume an API request but no live-search allowance. When rate limited, the API returns HTTP 429.
GET
/api/v1/leadsRetrieve your saved leads, paginated newest-first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | optional | Page number (default: 1) |
limit | integer | optional | Results per page, max 100 (default: 25) |
Example request
curl https://leadzipp.com/api/v1/leads \
-H "Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx"Response
{
"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 }
}GET
/api/v1/historyRetrieve your past searches, paginated newest-first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | optional | Page number (default: 1) |
limit | integer | optional | Results per page, max 100 (default: 25) |
Example request
curl https://leadzipp.com/api/v1/history \
-H "Authorization: Bearer lz_live_xxxxxxxxxxxxxxxxxxxx"Response
{
"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 }
}POST
/api/v1/searchRun a new lead search programmatically. A cache miss spends one live search from the workspace's 300 monthly allowance; a cached response spends none.
Parameters
| 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) |
Example request
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}'Response
{
"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