Datafiniti API

The Datafiniti Developer Hub

Welcome to the Datafiniti Developer Hub. Here you'll find comprehensive guides and documentation to help you start using the Datafiniti API as quickly as possible. Let's get some data!

Get Started    

Business Data Schema

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

Field Name
Example Value (in JSON)
Description

address

"address": "3382 30th St"

The physical street address for this business location.

careerPageURL

"careerPageURL": "http://www.searocketbistro.com/employment"

A URL pointing to the career page for the business.

categories

"categories": [
  "Seafood Restaurant",
  "Fish & Seafood Retail",
  "restaurant"
]

A list of category keywords used for this business across multiple sources.

city

"city": "San Diego"

The city of this business location.

claimed

"claimed": [
  "http://yellowpages.com/",
  "http://foursquare.com/"
]

A list of websites where the business location has been claimed by the business' owner.

country

"country": "US"

The two-letter country code for the business location's country.

cuisines

"cuisines": [
  "Seafood Restaurants",
  "Sandwich Shop",
  "Seafood, Vegetarian / Vegan, Mediterranean"
]

A list of cuisines offered by this business location. This field will only show for restaurants or other eating locations.

dateAdded

"dateAdded": "2016-03-24T09:27:02Z"

The date this business was first added to the business database.

dateUpdated

"dateUpdated": "2017-03-20T20:45:49Z"

The most recent date this business was updated or seen by our system.

descriptions

"descriptions": [
  {
    "dateSeen": [
      "2016-06-18T01:17:41Z"
    ],
    "sourceURLs": [
      "https://www.zagat.com/r/petes-seafood-and-sandwich-san-diego"
    ],
    "value": "Sizable made-to-order sandwiches, including lobster rolls, meatball Parmesan heroes and a variety of vegetarian options, are served at this East Coast–style sandwich shop nestled in the heart of North Park."
  }
]

A list of descriptions for this business from various sources. Each description contains:

  • dateSeen: A list of dates when this description has been seen for this business.
  • sourceURLs: A list of source URLs where this specific description was seen.
  • value: A unique description for this business.

emails

"emails": [
  "elena@searocketbistro.com"
]

A list of emails belonging to the business.

facebookPageURL

"facebookPageURL": "http://www.facebook.com/pages/Sea-Rocket-Bistro/114213985293774"

A URL pointing to the Facebook page for the business.

faxes

"faxes": [
  "3135619486"
]

A list of fax numbers for the business.

features

"features": [
  {
    "key": "attire",
    "value": [
      "Casual Dress"
    ]
  },
  {
    "key": "parking",
    "value": [
      "Street Parking",
      "Valet"
    ]
  }
]

A list of features associated with this business location. The feature list can be collected from specific feature sections available on listings for this business. It can also serve as a catch-all field for miscellaneous characteristics of this business that don't make sense to include as top-level fields.

Each feature contains:

  • key: A label for this feature.
  • value: A list of possible values for this feature.

hours

"hours": [
  {
    "day": "Mon - Fri",
    "hour": "11:00 am - 9:00 pm"
  },
  {
    "day": "Sat - Sun",
    "hour": "11:00 am - 10:00 pm"
  },
]

The hours of operation for this business location.

Each hour object may contain:

  • day: The day(s) for this hour of operation.
  • dept: The department or business unit related to this hour of operation.
  • hour: The hours of operation.

imageURLs

"imageURLs": [
  "https://irs0.4sqi.net/img/general/200x200/118688231_EmfdW9_8FpBrxsa5WDVektvkubj-XpCW5ln6s6pnClo.jpg",
  "https://irs0.4sqi.net/img/general/200x200/1556291_gjOF8nnudHh_ICSWXoTs75_FxtcKt25nZtwbqjaHtKQ.jpg",
]

A list of image URLs associated with this business.

isClosed

"isClosed": "false"

A true or false value for whether or not the business location is closed.

keys

"keys": [
  "us/ca/sandiego/338230thst/2075732923"
]

A list of internal Datafiniti identifiers for this business. The keys field is used to merge raw data from individual sources into the master Datafiniti record. Learn more about how this works.

languagesSpoken

"languagesSpoken: [
  "English",
  "Spanish"
]

A list of the languages spoken at this business.

latitude

"latitude": "32.740654"

The latitude coordinates for this business location.

longitude

"longitude": "-117.129482"

The longitude coordinates for this business location.

menuPageURL

"menuPageURL": "http://www.citysearch.com/profile/menu/648254644"

A URL pointing to the menu for the business. This field will only show for restaurants or other eating locations.

menus

"menus": [
  {
    "amountMin": 12,
    "amountMax": 12,
    "category": "sample menu",
    "currency": "USD",
    "dateSeen": [
      "2017-03-22T01:03:56Z"
    ],
    "name": "Fish Carpaccio",
    "sourceURLs": [
  "http://www.superpages.com/bp/san-diego-ca/petes-seafood-sandwich-L2615943735.htm"
    ]
  },
  {
    "amountMin": 7,
    "amountMax": 7,
    "category": "sample menu",
    "currency": "USD",
    "dateSeen": [
      "2017-03-22T01:03:56Z"
    ],
    "description": "A dense bread pudding recipe served cold with butterscotch sauce",
    "name": "Seasonal Pumpkin Bread Pudding",
    "sourceURLs": [
  "http://www.superpages.com/bp/san-diego-ca/petes-seafood-sandwich-L2615943735.htm"
    ]
  }
]

A list of menu items offered by the business. This field will only show for restaurants or other eating locations.

Each menu item may include:

  • amountMin: The minimum price value of the item.
  • amountMax: The maximum price value of the item. This is typically the same as amountMin, except in cases where a price range is listed.
  • category: The menu section this item belongs to.
  • currency: The currency listed for amountMin and amountMax.
  • dateSeen: A list of dates when this item was seen.
  • description: A description for the item.
  • name: The item's name on the menu.
  • sourceURLs: A list of URLs where this item was seen.

name

"name": "Pete's Seafood & Sandwich"

The business location's name.

neighborhoods

"neighborhoods": [
  "North Park, Western San Diego",
  "North Park"
]

A list of neighborhoods where this business is located. Sometimes an area can belong to multiple neighborhoods, which is why this field is a list.

numEmployeesMin

"numEmployeesMin": "5"

The lower bound on the number of people possibly employed by this business.

numEmployeesMax

"numEmployeesMax": "10"

The upper bound on the number of people employed by this business.

numRoom

"numRoom": 10

The number of rooms available at this business. This field typically shows for hotels or other similar businesses.

paymentTypes

"paymentTypes":[
  "American Express",
  "Mastercard",
  "Visa"
]

A list of payment options accepted by the business.

people

"people": [
  {
    "dateSeen": [
      "2014-08-22T03:48:23Z"
    ],
    "name": "Cody Jones",
    "title": "Owner"
  },
  {
    "dateSeen": [
      "2014-08-22T03:48:23Z"
    ],
    "name": "Chaseee Ewing",
    "title": "Head Chef"
  }
]

A list of known people associated with or employed by this business.

Each person may contain:

  • dateSeen: A list of dates when this person was seen.
  • name: The person's name.
  • title: The person's title.

phones

"phones": [
  "6192558940",
  "6195734102"
]

A list of phone numbers for the business.

postalCode

"postalCode": "92014"

The postal or zip code of the business' location.

priceRangeCurrency

"priceRangeCurrency": "USD"

The currency associated with the price range fields.

priceRangeMin

"priceRangeMin": 25

The lower bound of the business' price range. This field is typically used for retail businesses.

priceRangeMax

"priceRangeMax": 40

The upper bound of the business' price range. This field is typically used for retail businesses.

productsOrServices

"productsOrServices": [
  "Food",
  "Catering"
]

A list of products or services offered by this business.

province

"province": "CA"

The province or state for this business location.

revenueCurrency

"revenueCurrency": "USD"

The currency associated with the revenue fields.

revenueMin

"revenueMin": 30000

The minimum known value of the business' annual revenue.

revenueMax

"revenueMax": 100000

The maximum known value of the business' annual revenue.

reviews

"reviews": [
  {
    "date": "2016-02-27T00:00:00Z",
    "dateAdded": "2017-03-20T20:45:49Z",
    "dateSeen": [
      "2016-05-17T00:00:00Z",
      "2016-05-13T00:00:00Z",
    ],
    "sourceURLs": [
    "https://foursquare.com/v/petes-seafood--sandwich/56391bfacd105fac6c403c63"
    ],
    "text": "best fried ipswich clams in san diego!  large portions- not just the 6-8 clams you get at other local eateries. great service! i will be back!",
    "username": "Colleen Alarcon"
  },
  {
    "date": "2016-02-15T00:00:00Z",
    "dateAdded": "2017-03-20T20:45:49Z",
    "dateSeen": [
      "2016-05-17T00:00:00Z",
      "2016-05-13T00:00:00Z",
    ],
    "sourceURLs": [


  "https://foursquare.com/v/petes-seafood--sandwich/56391bfacd105fac6c403c63"
    ],
    "text": "the lobster roll is simply amazing!!!",
    "username": "P. Chunyi Hsu"
  }
]

A list of reviews for this business location.

Review objects may contain:

  • date: The date the review was posted.
  • dateAdded: The date the review was added to Datafiniti.
  • dateSeen: A list of dates when the review was seen by Datafiniti.
  • doRecommend: A true/false for whether or not the reviewer recommends the product.
  • id: The website ID associated with this review.
  • rating: A 1 to 5 star value for the review.
  • sourceURLs: A list of URLs where this review was seen.
  • text: The full (or available) text of the review.
  • title: The review's title.
  • userCity: The reviewer's city.
  • username: The reviewer's username.
  • userProvince: The reviewer's province or state.

rooms

"rooms": [
  {
    "amountMin": 90,
    "amountMax": 90,
    "capacity": 3,
    "currency": "USD",
    "dateSeen": [
      "2016-05-04T00:00:00Z"
    ],
    "roomType": "Standard Room"
  },
  {
    "amountMin": 119,
    "amountMax": 119,
    "capacity": 4,
    "currency": "USD",
    "dateSeen": [
      "2016-05-04T00:00:00Z"
    ],
    "roomType": "Superior Room"
  }
]

A list of room types available at the business' location. This field is typically associated with hotels and other similar businesses.

Room objects may contain:

  • amountMin: The minimum price value listed for the room.
  • amountMax: The maximum price value listed.
  • capacity: The maximum number of people that can occupy this room.
  • currency: The currency listed for amountMin and amountMax.
  • dateSeen: A list of dates when this room was seen.
  • roomType: A classification for the type of room.

sic

"sic": "5610"

The SIC code for the business. Learn more about SIC codes.

sourceURLs

"sourceURLs": [
  "http://www.superpages.com/bp/san-diego-ca/petes-seafood-sandwich-L2615943735.htm",
  "https://foursquare.com/v/petes-seafood--sandwich/56391bfacd105fac6c403c63",
  "https://www.zagat.com/r/petes-seafood-and-sandwich-san-diego",
]

A list of URLs used to generate data for this business location.

twitter

"twitter": "sdpark2park"

The twitter username for the business.

websites

"websites": [
  "http://www.bostonpetes.com/",
  "http://www.searocketbistro.com"
]

A list of websites for the business.

yearIncorporated

"yearIncorporated": 2004

The year the business was incorporated.

yearOpened

"yearOpened": 2005

The year the business opened.

Business Data Schema