LeadAtlas

Developer API

REST JSON API. One query per request, whatever the page size. Facets and /me are free.

Authentication

Create a key in the dashboard, then send:

Authorization: Bearer la_live_…

Base URL

https://leadatlas.161.97.155.24.nip.io/api/v1

GET /api/v1/me

Plan, quotas, and page limits (free).

curl -H "Authorization: Bearer $KEY" https://leadatlas.161.97.155.24.nip.io/api/v1/me

GET /api/v1/search

Query params match the UI: q, country, city, sector, category, has_phone, has_website, per_page, page.

curl -G "https://leadatlas.161.97.155.24.nip.io/api/v1/search" \
  -H "Authorization: Bearer $KEY" \
  --data-urlencode "q=dental" \
  --data-urlencode "country=saudi" \
  --data-urlencode "has_phone=1" \
  --data-urlencode "per_page=10"

GET /api/v1/places/{id}

Single place (1 query).

GET /api/v1/facets

Countries, cities, sectors (free).

Paging limits

per_page is capped by your plan, and pages past your plan allowance return 402 with the total match count so you know what an upgrade unlocks.

{
  "error": "page_locked",
  "total": 552,
  "visible": 20,
  "max_pages": 1,
  "per_page": 20
}

Response headers

Errors

Start free