LEleadmagic
Local Leads

Search Local Leads

Changed on

Search 59 million local business listings by location, category, name or map radius. Each lead is the full listing: address, coordinates, phones, emails, website and socials.

Pages hold 25 leads and the size is fixed: limit, offset and page return 400. Page with next_cursor. A search holds up to 1,000 leads for 30 minutes.

Zero credits on Professional (5 requests/second) and Ultimate (10 requests/second), within the fair-use ceilings of 10 million records/month and 13,333 searches/day shared across People, Company, Jobs and Local Leads Search. Other plans pay 1 credit per page at 5 requests/second. A page that is read again within 30 minutes is not charged again.

Every search needs a country, a point (lat and lon), a website_domain, email_domain or email, or a name of five or more characters.

post/v3/local-leads/search

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

Request body

streetstring

Text contained in the street address. Needs country.

namestring

Text contained in the business name.

emailstring

An exact email address on the listing.

phonestring

A phone number in any format, 7 to 15 digits. Needs country.

has_emailboolean
has_business_emailboolean

An email on the business's own domain, not a free mailbox.

has_phoneboolean
has_websiteboolean
has_socialboolean
is_chainboolean
min_confidencenumber
exclude_closedboolean

True keeps open and unknown listings only.

latnumber

Latitude of a point search. Send with lon. Results are nearest first.

lonnumber

Longitude of a point search. Send with lat.

radius_minteger

Radius of a point search, in metres.

sort'confidence' | 'name'

Not allowed with a point search.

cursorstring

next_cursor from the previous page, sent with the same filters.

Response

One page of local leads (flat JSON body: not wrapped in data)

messagestring required
credits_consumednumber required

0 on Professional and Ultimate, and 0 when the page was already paid for

credits_previously_consumednumber

Present when the page was first read by an earlier request

countinteger required

Leads in this page

page_sizeinteger required

Always 25

totalinteger nullable

Every listing the search matches; null when the count did not finish in time

has_moreboolean required

More pages remain in the stored result list

next_cursorstring nullable

Send back as cursor for the next page; null on the last page

has_more_beyond_snapshotboolean

The search matches more than the 1,000 leads it holds

snapshot_limit_reachedboolean

This is the last page of the 1,000 and more listings exist

interpreted_searchobject

The filters as they were applied

Example response

{
  "message": "Local leads found",
  "credits_consumed": 1,
  "leads": [
    {
      "category": "plumbing",
      "category_group": "services_and_business",
      "country": "US"
    }
  ],
  "count": 25,
  "page_size": 25,
  "total": 20627,
  "metadata": {
    "query_name": "local_leads_search_v3",
    "pagination": "snapshot"
  }
}

Changes