Quick search: one city, answered in the same request

Synchronous and small: one city, paging from its centre, up to 100 listings (5 pages × 20), returned in the response with result_ids. Each NEW listing costs 1 lead and a page of nothing new costs nothing. For whole-area coverage use POST /api/v1/searches with mode "grid", which finds several times more in a dense metro.

post/api/v1/search

Request

  • Base URL: https://lyreleads.com
  • URL: https://lyreleads.com/api/v1/search
  • Auth: HTTP bearer

Request body

querystring required

Business type or keyword

citystring required

City to search in

countrystring required

Country name

pagesinteger

Pages of results (1–5, 20 results each)

Example request

{
  "query": "plumbers",
  "city": "Berlin",
  "country": "Germany"
}

Response

Array of business results with leads_used and leads_remaining

Changes

No recorded changes to this operation across all 1 revision of this API.