factual

Factual Developer Documenation

Welcome to the factual-devdocs developer hub. You'll find comprehensive guides and documentation to help you start working with factual-devdocs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Extended Attributes

In addition to the core attributes, Factual Places contains a multitude of extended attributes. These extended attributes are divided into classes, each with a varying degree of country coverage. Each class of extended attributes can be licensed at an additional charge (please speak to your Factual representative for more information). See below for details of what is offered.

Restaurants

Factual has extended attributes for restaurants records in five countries: US, AU, DE, FR, and GB. Please refer to the categories taxonomy for a comprehensive list of categories that have restaurant extended attributes.

No.AttributeDatatypeDescription
1cuisineArray (String)Loose description of the food served. See here for the full list of cuisines.
2priceIntegerA value between 1 and 5 representing the price per person. The following scale is an extremely coarse guide: 1 = $0-$15, 2 = $15-$30, 3 = $30-$50, 4 = $50-$75, 5 = $75+. Usually represented graphically by dollar symbols or the local currency equivalent.
3ratingDecimalA rating between 1 and 5, rounded to nearest half; usually represented graphically by stars. Calculated as the mean of multiple rating rollups across various sites and partners.
4payment_cashonlyBooleanOnly accepts cash
5reservationsBooleanAccepts reservations
6open_24hrsBooleanOpen 24x7
7foundedStringYear founded
8attireStringRecommended attire. Can be one of five values: streetwear, casual, business casual, smart casual, formal.
9attire_requiredArray (String)Required attire (i.e., must have this on to be admitted). One or more values from the following list: shirt with collar, shirt, shoes, jacket, tie.
10attire_prohibitedArray (String)Prohibited attire (i.e., will not be admitted if you are sporting this). One or more strings from the following list: denim, cuttoffs, tank tops, sneakers, flipflops, sandals, hats, athletic wear, sports wear, boots.
11parkingBooleanSome form of parking is advertised. This will be true when any other parking attributes are true.
12parking_valetBooleanValet parking is available
13parking_garageBooleanGarage parking is available
14parking_streetBooleanParking on-street is available
15parking_lotBooleanParking lot adjacent, not necessarily dedicated to this place
16parking_validatedBooleanValidated parking is available
17parking_freeBooleanFree parking is available
18smokingBooleanAllows smoking somewhere
19meal_breakfastBooleanServes breakfast
20meal_lunchBooleanServes lunch
21meal_dinnerBooleanServes dinner
22meal_deliverBooleanDelivers
23meal_takeoutBooleanProvides takeout/takeaway
24meal_caterBooleanProvides catering
25alcoholBooleanAlcohol is served or can be consumed on the premesis. This will be true when any other alcohol attributes are true.
26alcohol_barBooleanHas a full bar
27alcohol_beer_wineBooleanServes beer and wine only
28alcohol_byobBoolean"Bring Your Own Bottle" rules apply
29kids_goodforBooleanNoted as being good for kids
30kids_menuBooleanHas a kids menu
31groups_goodforBooleanNoted as being good for groups
32accessible_wheelchairBooleanPremesis are explicitly noted as being accessible by wheelchair
33seating_outdoorBooleanOutdoor seating is available
34wifiBooleanWifi is provided by the establishment
35ownerStringOwner name(s)
36room_privateBooleanPrivate dining room is available
37options_vegetarianBooleanVegetarian options noted
38options_veganBooleanVegan options noted
39options_glutenfreeBooleanGluten-free items noted
40options_lowfatBooleanLowfat options noted
41options_organicBooleanOrganic options noted
42options_healthyBooleanHealthy dishes are explicitly available

Hotels

Factual has extended attributes for hotels records in the US. Please refer to the categories taxonomy for a comprehensive list of categories that have hotel extended attributes.

No.AttributeDatatypeDescription
1air_conditioningBooleanAir conditioning in rooms and/or public areas
2complimentary_breakfastBooleanComplimentary breakfast included in the price
3lowest_priceIntegerLowest dollar figure found
4highest_priceIntegerHighest dollar figure found
5depositIntegerDeposit per stay
6room_countIntegerTotal number of rooms
7starsIntegerStar rating
8petsArray (String)Pets allowed. Predominant values are true and false. true may be accompanied by fee if a fee is charged.
9non_smoking_roomsArray (String)Non smoking rooms available. Predominant values are true and false. true may be accompanied by non-smoking only if the hotel contains only non-smoking rooms.
10smokingBooleanSmoking allowed somewhere on the premises
11internetArray (String)In-room internet availability. Predominant values are true and false. true may be accompanied by values for internet type: free, surcharge, wired, and wireless.
12poolArray (String)Pool availability. Predominant values are true and false. true may be followed by values for pool type: heated, indoor, outdoor, and outdoor seasonal.
13fitness_facilitiesBooleanFitness/weight room or health club
14check_inStringCheck-in time. 24 hour clock format.
15check_outStringCheck-out time. 24 hour clock format.
16business_centerBooleanBusiness center availability
17express_check_inBooleanHas express check-in
18express_check_outBooleanHas express check-out
19laundry_serviceBooleanDry cleaning and/or laundry service
20cable_tvBooleanCable or satellite TV in-room
21room_serviceArray (String)Room service availability. Predominant values are true and false. true may be accompanied by 24 hour.
22accessibilityArray (String)Handicapped accessibility. Possible values are: wheelchair accessible, accessible bathroom, equipment for the deaf, handicapped parking.
23spa_servicesArray (String)Spa services on-site. Predominant values are true and false. true may be accompanied by jacuzzi, sauna, massage, and whirlpool.
24cribsBooleanCribs, cots, or infant beds available
25restaurantBooleanIncludes Hotel Restaurant
26conciergeBooleanConcierge service
27barBooleanIncludes Hotel Bar
28twentyfour_hour_front_deskBooleanFull time front desk
29meeting_roomsBooleanMeeting Rooms Available
30banquet_facilitiesBooleanLarge rooms and catering facilities
31event_cateringBooleanLarge event catering
32complimentary_newspapersBooleanComplimentary newspapers available
33review_countIntegerTotal number of known reviews across sources
34ratingDecimalA rating between 1 and 5, rounded to nearest half; usually represented graphically by stars. Calculated as the mean of multiple rating rollups across various sites and partners.
35typeArryay (String)Hotel sub-categorization
36roll_out_bedsArray (String)Roll-out beds available. Predominant values are true and false.
37parking_detailsArray (String)Parking Availability. Predominant values are true and false. true may be accompanied by parking details.

Healthcare Providers

Factual has extended attributes for doctors and healthcare providers records in the US. Please refer to the categories taxonomy for a comprehensive list of categories that have healthcare provider extended attributes.

No.AttributeDatatypeDescription
1degreesArray (String)List of medical degrees attained
2educationArray (String)List of institutes of medical education
3genderStringmale or female
4affiliationsArray (String)List of affiliated hospitals and practices
5years_experienceIntegerNumber of years in practice
6insurancesArray (String)List of accepted insurance plans
7npi_idInteger10-digit National Provider Identifier number
8languagesArray (String)List of languages

Placerank

Placerank is an attribute representing the relative popularity or significance of a point-of-interest. It is a score from 1 to 100, with 1 being the least popular and 100 being the most popular. Common use cases for utilizing PlaceRank include ordering geo search results and informing place visibility at different zoom levels in a mapping application. PlaceRank is available in all Factual countries.

No.AttributeDatatypeDescription
1placerankIntegerPopularity score ranging from 1 (lowest) to 100 (highest)

Crosswalk

Factual maps many of its records to analogous IDs and URLs across multiple namespaces. Crosswalk is available across all Factual countries, though each namespace will have different levels of coverage. The following namespaces are currently available:

  • Facebook
  • Foursquare
  • Grubhub
  • Instagram
  • Lonely Planet
  • OpenTable
  • SinglePlatform
  • StubHub
  • TripAdvisor
  • Twitter
  • Wikipedia
  • Yelp
  • Zagat
No.AttributeDatatypeDescription
1crosswalk_id_facebookIntegerFacebook ID
2crosswalk_url_facebookStringFacebook URL
3crosswalk_id_foursquareStringFoursquare ID
4crosswalk_url_foursquareStringFoursquare URL
5crosswalk_url_grubhubStringGrubHub URL
6crosswalk_id_instagramIntegerInstagram ID (i.e., NOT Instagram handle)
7crosswalk_url_instagramStringInstagram URL
8crosswalk_url_lonelyplanetStringLonely Planet URL
9crosswalk_url_opentableStringOpenTable URL
10crosswalk_id_opentableStringOpenTable ID
11crosswalk_url_singleplatformStringSinglePlatform URL
12crosswalk_url_stubhubStringStubhub URL
13crosswalk_id_tripadvisorStringTripAdvisor ID
14crosswalk_url_tripadvisorStringTripAdvisor URL
15crosswalk_id_twitterStringTwitter ID (i.e., Twitter handle)
16crosswalk_url_twitterStringTwitter URL
17crosswalk_url_wikipediaStringWikipedia URL
18crosswalk_id_yelpStringYelp ID
19crosswalk_url_yelpStringYelp URL
20crosswalk_url_zagatStringZagat URL

Updated about a year ago

Extended Attributes


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.