INinstantly
LocalBusiness

Search local businesses

Changed on

Finds local businesses by category and location. Searching is free and returns up to 5 businesses per page; a workspace may read 200 pages a day (429 local_business_search_daily_limit after that). Emails are revealed only by converting.

Requires one of the following scopes: supersearch_enrichments:read, supersearch_enrichments:all, all:read, all:all

post/api/v2/local-business-search/search

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/local-business-search/search
  • Auth
    HTTP bearer

Request body

page_sizeinteger

Example request

{
  "filters": {
    "categories": [
      "dentist"
    ],
    "location": {
      "label": "Austin, TX",
      "country": "US",
      "state": "TX",
      "city": "Austin",
      "lat": 30.2672,
      "long": -97.7431,
      "radius_km": 10
    }
  }
}

Response

Up to 200 search pages a day per workspace; searching is free.

totalinteger nullable required

How many businesses match; may be null

Example response

{
  "items": [
    {
      "id": "b4d0c7e2-1f3a-4c55-9a6e-2d8f1b7c3e90",
      "place_id": "f3a91c0e5b7d",
      "name": "Bright Smile Dental",
      "category": "Dentist",
      "address": "100 Congress Ave",
      "city": "Austin",
      "state": "TX",
      "country": "US",
      "lat": 30.2672,
      "long": -97.7431,
      "website": "https://brightsmile.example",
      "domain": "brightsmile.example",
      "rating": 4.7,
      "reviews": 182,
      "locations": 1,
      "has_email": true
    }
  ],
  "filters": {
    "categories": [
      "dentist"
    ],
    "location": {
      "label": "Austin, TX",
      "country": "US",
      "state": "TX",
      "city": "Austin",
      "lat": 30.2672,
      "long": -97.7431,
      "radius_km": 10
    }
  }
}

Changes