Businesses & POI
Business Data API

List Business Records

Retrieve business records with optional enrichment data.

This endpoint provides access to millions of business listings with support for pagination and selective data enrichment. Choose which enrichments to include (contacts, emails, phone numbers, company insights, email verification, etc.) to optimize response size and cost.

Perfect for building lead lists, market research, or populating your CRM with verified business data.

post/businesses

Request

  • Base URL: https://api.outscraper.cloud
  • URL: https://api.outscraper.cloud/businesses
  • Auth: API key in header X-API-KEY

Request body

filtersBusinessesFilters (unresolved $ref)
limitinteger

Maximum number of business records to return.

cursorstring nullable

Cursor for pagination to retrieve the next set of results.

querystring nullable

Natural language query to search for businesses (e.g., restaurants in New York). This is an alternative to using structured filters and can be used in combination with them. The API will attempt to parse the query and apply relevant filters based on the content.

include_totalboolean

Whether to include the total count of matching records in the response. This could increase response time.

fieldsstring[]

List of fields to include in the response. If not specified, all fields will be returned.

Example request

{
  "filters": {
    "country_code": "US",
    "states": [
      "NY"
    ],
    "cities": [
      "New York",
      "Buffalo"
    ],
    "types": [
      "restaurant",
      "cafe"
    ],
    "has_website": true,
    "email_and_phone": "with_phone",
    "business_statuses": [
      "operational"
    ]
  },
  "limit": 10,
  "cursor": null,
  "include_total": false,
  "enrichments": {
    "leads_n_contacts": {
      "contacts_per_company": 3,
      "emails_per_contact": 1
    },
    "company_insights": {}
  }
}

Response

Changes

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