> For the complete documentation index, see [llms.txt](https://docs.datafiniti.co/llms.txt).
> Use it to discover all available pages before exploring further.

# Business Data Schema

The business data schema below lists all available fields in a business record.  Note that actual business records (most of them) may not contain every field.

# Business Operation Fields

<ParamField body="hours" param-type="nested" required="false" deprecated="false" show-location="false">
  The hours of operation for this business location.

  **Example:**

  ```json
  "hours": [
    {
      "day": "Mon - Fri",
      "dept": "Sales",
      "hour": "11:00 am - 9:00 pm"
    },
    {
      "day": "Sat - Sun",
      "meal": "Brunch",
      "hour": "11:00 am - 10:00 pm"
    }
  ]
  ```

  <Expandable title="Sub-fields">
    <ParamField body="hours.day" param-type="text" required="false" deprecated="false" show-location="false">
      The day(s) for this hour of operation.
    </ParamField>
    <ParamField body="hours.dept" param-type="text" required="false" deprecated="false" show-location="false">
      The department or business unit related to this hour of operation.
    </ParamField>
    <ParamField body="hours.hour" param-type="text" required="false" deprecated="false" show-location="false">
      The hours of operation.
    </ParamField>
    <ParamField body="hours.meal" param-type="text" required="false" deprecated="false" show-location="false">
      The meal period associated with this hour of operation.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="isClosed" param-type="boolean" required="false" deprecated="false" show-location="false">
  A `true` or `false` value for whether or not the business location is closed.

  **Example:**

  ```json
  "isClosed": false
  ```
</ParamField>

<ParamField body="languagesSpoken" param-type="text" required="false" deprecated="false" show-location="false">
  A list of the languages spoken at this business.

  **Example:**

  ```json
  "languagesSpoken": [
    "English",
    "Spanish"
  ]
  ```
</ParamField>

<ParamField body="paymentTypes" param-type="text" required="false" deprecated="false" show-location="false">
  A list of payment options accepted by the business.

  **Example:**

  ```json
  "paymentTypes": [
    "American Express",
    "Mastercard",
    "Visa"
  ]
  ```
</ParamField>

<ParamField body="productsOrServices" param-type="text" required="false" deprecated="false" show-location="false">
  A list of products or services offered by this business.

  **Example:**

  ```json
  "productsOrServices": [
    "Food",
    "Catering"
  ]
  ```
</ParamField>

# Classification Fields

<ParamField body="categories" param-type="text" required="false" deprecated="false" show-location="false">
  A list of category keywords used for this business across multiple sources.

  **Example:**

  ```json
  "categories": [
    "Seafood Restaurant",
    "Fish & Seafood Retail",
    "restaurant",
    "thing"
  ]
  ```
</ParamField>

<ParamField body="name" param-type="text" required="false" deprecated="false" show-location="false">
  The business location's name.

  **Example:**

  ```json
  "name": "Pete's Seafood & Sandwich"
  ```
</ParamField>

<ParamField body="primaryCategories" param-type="text" required="false" deprecated="false" show-location="false">
  A list of standardized categories to which this business belongs. Category values can be found [here](/docs/possible-values-for-business-fields).

  **Example:**

  ```json
  "primaryCategories": [
    "Retail"
  ]
  ```
</ParamField>

<ParamField body="sic" param-type="text" required="false" deprecated="false" show-location="false">
  The SIC code for the business. [Learn more about SIC codes](https://en.wikipedia.org/wiki/Standard_Industrial_Classification).

  **Example:**

  ```json
  "sic": "5610"
  ```
</ParamField>

<ParamField body="yearIncorporated" param-type="integer" required="false" deprecated="false" show-location="false">
  The year the business was incorporated.

  **Example:**

  ```json
  "yearIncorporated": 2004
  ```
</ParamField>

<ParamField body="yearOpened" param-type="integer" required="false" deprecated="false" show-location="false">
  The year the business opened.

  **Example:**

  ```json
  "yearOpened": 2005
  ```
</ParamField>

# Contact Fields

<ParamField body="emails" param-type="text" required="false" deprecated="false" show-location="false">
  A list of emails belonging to the business.

  **Example:**

  ```json
  "emails": [
    "elena@searocketbistro.com"
  ]
  ```
</ParamField>

<ParamField body="facebookPageURL" param-type="text" required="false" deprecated="false" show-location="false">
  A URL pointing to the Facebook page for the business.

  **Example:**

  ```json
  "facebookPageURL": "http://www.facebook.com/pages/Sea-Rocket-Bistro/114213985293774"
  ```
</ParamField>

<ParamField body="faxes" param-type="text" required="false" deprecated="false" show-location="false">
  A list of fax numbers for the business.

  **Example:**

  ```json
  "faxes": [
    "3135619486"
  ]
  ```
</ParamField>

<ParamField body="phones" param-type="keyword" required="false" deprecated="false" show-location="false">
  A list of phone numbers for the business.

  **Example:**

  ```json
  "phones": [
    "6192558940",
    "6195734102"
  ]
  ```
</ParamField>

<ParamField body="twitter" param-type="text" required="false" deprecated="false" show-location="false">
  The twitter username for the business.

  **Example:**

  ```json
  "twitter": "sdpark2park"
  ```
</ParamField>

<ParamField body="websites" param-type="keyword" required="false" deprecated="false" show-location="false">
  A list of websites for the business.

  **Example:**

  ```json
  "websites": [
    "http://www.bostonpetes.com/",
    "http://www.searocketbistro.com"
  ]
  ```
</ParamField>

# Firmographic Fields

<ParamField body="numEmployeesMax" param-type="integer" required="false" deprecated="false" show-location="false">
  The upper bound on the number of people employed by this business.
</ParamField>

<ParamField body="numEmployeesMin" param-type="integer" required="false" deprecated="false" show-location="false">
  The lower bound on the number of people possibly employed by this business.
</ParamField>

<ParamField body="people" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of known people associated with or employed by this business.

  <Expandable title="Sub-fields">
    <ParamField body="people.dateSeen" param-type="text" required="false" deprecated="false" show-location="false">
      A list of dates when this person was seen.
    </ParamField>
    <ParamField body="people.name" param-type="text" required="false" deprecated="false" show-location="false">
      The person's name.
    </ParamField>
    <ParamField body="people.title" param-type="text" required="false" deprecated="false" show-location="false">
      The person's title.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="revenueCurrency" param-type="keyword" required="false" deprecated="false" show-location="false">
  The currency associated with the revenue fields.
</ParamField>

<ParamField body="revenueMax" param-type="integer" required="false" deprecated="false" show-location="false">
  The maximum known value of the business' annual revenue.
</ParamField>

<ParamField body="revenueMin" param-type="integer" required="false" deprecated="false" show-location="false">
  The minimum known value of the business' annual revenue.
</ParamField>

# Geographic Fields

<ParamField body="address" param-type="text" required="false" deprecated="false" show-location="false">
  The physical street address for this business location.
</ParamField>

<ParamField body="city" param-type="text" required="false" deprecated="false" show-location="false">
  The city of this business location.
</ParamField>

<ParamField body="country" param-type="text" required="false" deprecated="false" show-location="false">
  The two-letter country code for the business location's country.
</ParamField>

<ParamField body="geoLocation" param-type="geo_shape" required="false" deprecated="false" show-location="false">
  A location value that stores the latitude and longitude in a format that allows geospatial querying.
</ParamField>

<ParamField body="latitude" param-type="text" required="false" deprecated="false" show-location="false">
  The latitude coordinates for this business location.
</ParamField>

<ParamField body="longitude" param-type="text" required="false" deprecated="false" show-location="false">
  The longitude coordinates for this business location.
</ParamField>

<ParamField body="neighborhoods" param-type="text" required="false" deprecated="false" show-location="false">
  A list of neighborhoods where this business is located.
</ParamField>

<ParamField body="postalCode" param-type="keyword" required="false" deprecated="false" show-location="false">
  The postal or zip code of the business' location.
</ParamField>

<ParamField body="province" param-type="text" required="false" deprecated="false" show-location="false">
  The province or state for this business location.
</ParamField>

# Generic Fields

<ParamField body="dateAdded" param-type="date" required="false" deprecated="false" show-location="false">
  The date this business was first added to the business database.
</ParamField>

<ParamField body="dateUpdated" param-type="date" required="false" deprecated="false" show-location="false">
  The most recent date this business was updated or seen by our system.
</ParamField>

<ParamField body="descriptions" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of descriptions for this business from various sources.

  <Expandable title="Sub-fields">
    <ParamField body="descriptions.dateSeen" param-type="text" required="false" deprecated="false" show-location="false">
      A list of dates when this description has been seen for this business.
    </ParamField>
    <ParamField body="descriptions.sourceURLs" param-type="text" required="false" deprecated="false" show-location="false">
      A list of source URLs where this specific description was seen.
    </ParamField>
    <ParamField body="descriptions.value" param-type="text" required="false" deprecated="false" show-location="false">
      A unique description for this business.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="features" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of features associated with this business location.

  <Expandable title="Sub-fields">
    <ParamField body="features.key" param-type="text" required="false" deprecated="false" show-location="false">
      A label for this feature.
    </ParamField>
    <ParamField body="features.value" param-type="text" required="false" deprecated="false" show-location="false">
      A list of possible values for this feature.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="keys" param-type="keyword" required="false" deprecated="false" show-location="false">
  A list of internal Datafiniti identifiers for this business.
</ParamField>

# Hospitality Fields

<ParamField body="numRoom" param-type="integer" required="false" deprecated="false" show-location="false">
  The number of rooms available at this business.
</ParamField>

<ParamField body="rooms" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of room types available at the business' location.

  <Expandable title="Sub-fields">
    <ParamField body="rooms.amountMin" param-type="float" required="false" deprecated="false" show-location="false">
      The minimum price value listed for the room.
    </ParamField>
    <ParamField body="rooms.amountMax" param-type="float" required="false" deprecated="false" show-location="false">
      The maximum price value listed.
    </ParamField>
    <ParamField body="rooms.capacity" param-type="integer" required="false" deprecated="false" show-location="false">
      The maximum number of people that can occupy this room.
    </ParamField>
    <ParamField body="rooms.currency" param-type="keyword" required="false" deprecated="false" show-location="false">
      The currency listed for amountMin and amountMax.
    </ParamField>
    <ParamField body="rooms.dateSeen" param-type="text" required="false" deprecated="false" show-location="false">
      A list of dates when this room was seen.
    </ParamField>
    <ParamField body="rooms.roomType" param-type="text" required="false" deprecated="false" show-location="false">
      A classification for the type of room.
    </ParamField>
  </Expandable>
</ParamField>

# Restaurant Fields

<ParamField body="cuisines" param-type="text" required="false" deprecated="false" show-location="false">
  A list of cuisines offered by this business location.
</ParamField>

<ParamField body="menuPageURL" param-type="keyword" required="false" deprecated="false" show-location="false">
  A URL pointing to the menu for the business.
</ParamField>

<ParamField body="menus" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of menu items offered by the business.

  <Expandable title="Sub-fields">
    <ParamField body="menus.amountMin" param-type="float" required="false" deprecated="false" show-location="false">
      The minimum price value of the item.
    </ParamField>
    <ParamField body="menus.amountMax" param-type="float" required="false" deprecated="false" show-location="false">
      The maximum price value of the item. This is typically the same as amountMin, except in cases where a price range is listed.
    </ParamField>
    <ParamField body="menus.category" param-type="text" required="false" deprecated="false" show-location="false">
      The menu section this item belongs to.
    </ParamField>
    <ParamField body="menus.currency" param-type="keyword" required="false" deprecated="false" show-location="false">
      The currency listed for amountMin and amountMax.
    </ParamField>
    <ParamField body="menus.dateSeen" param-type="text" required="false" deprecated="false" show-location="false">
      A list of dates when this item was seen.
    </ParamField>
    <ParamField body="menus.description" param-type="text" required="false" deprecated="false" show-location="false">
      A description for the item.
    </ParamField>
    <ParamField body="menus.name" param-type="text" required="false" deprecated="false" show-location="false">
      The item's name on the menu.
    </ParamField>
    <ParamField body="menus.sourceURLs" param-type="text" required="false" deprecated="false" show-location="false">
      A list of URLs where this item was seen.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="priceRangeCurrency" param-type="keyword" required="false" deprecated="false" show-location="false">
  The currency associated with the price range fields.
</ParamField>

<ParamField body="priceRangeMax" param-type="float" required="false" deprecated="false" show-location="false">
  The upper bound of the business' price range.
</ParamField>

<ParamField body="priceRangeMin" param-type="float" required="false" deprecated="false" show-location="false">
  The lower bound of the business' price range.
</ParamField>

# Reviews Fields

<ParamField body="reviews" param-type="nested" required="false" deprecated="false" show-location="false">
  A list of reviews for this business location.

  <Expandable title="Sub-fields">
    <ParamField body="reviews.date" param-type="date" required="false" deprecated="false" show-location="false">
      The date the review was posted.
    </ParamField>
    <ParamField body="reviews.dateAdded" param-type="date" required="false" deprecated="false" show-location="false">
      The date the review was added to Datafiniti.
    </ParamField>
    <ParamField body="reviews.dateSeen" param-type="text" required="false" deprecated="false" show-location="false">
      A list of dates when the review was seen by Datafiniti.
    </ParamField>
    <ParamField body="reviews.doRecommend" param-type="boolean" required="false" deprecated="false" show-location="false">
      A true/false for whether or not the reviewer recommends the business.
    </ParamField>
    <ParamField body="reviews.id" param-type="keyword" required="false" deprecated="false" show-location="false">
      The website ID associated with this review.
    </ParamField>
    <ParamField body="reviews.rating" param-type="float" required="false" deprecated="false" show-location="false">
      A 1 to 5 star value for the review.
    </ParamField>
    <ParamField body="reviews.sourceURLs" param-type="keyword" required="false" deprecated="false" show-location="false">
      A list of URLs where this review was seen.
    </ParamField>
    <ParamField body="reviews.text" param-type="text" required="false" deprecated="false" show-location="false">
      The full (or available) text of the review.
    </ParamField>
    <ParamField body="reviews.title" param-type="text" required="false" deprecated="false" show-location="false">
      The review's title.
    </ParamField>
    <ParamField body="reviews.userCity" param-type="text" required="false" deprecated="false" show-location="false">
      The reviewer's city.
    </ParamField>
    <ParamField body="reviews.username" param-type="text" required="false" deprecated="false" show-location="false">
      The reviewer's username.
    </ParamField>
    <ParamField body="reviews.userProvince" param-type="text" required="false" deprecated="false" show-location="false">
      The reviewer's province or state.
    </ParamField>
  </Expandable>
</ParamField>

# Source Fields

<ParamField body="claimed" param-type="keyword" required="false" deprecated="false" show-location="false">
  A list of websites where the business owner has claimed the business location.
</ParamField>

<ParamField body="domains" param-type="domain" required="false" deprecated="false" show-location="false">
  A list of each unique domain found in the `sourceURLs` field.
</ParamField>

<ParamField body="imageURLs" param-type="text" required="false" deprecated="false" show-location="false">
  A list of image URLs associated with this business.
</ParamField>

<ParamField body="sourceURLs" param-type="keyword" required="false" deprecated="false" show-location="false">
  A list of URLs used to generate data for this business location.
</ParamField>

