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    

Categories

Factual attempts to apply accurate and granular categorization to each of our POI records. In order to accomplish this, we leverage our own proprietary taxonomy of 475 categories. Please see below for more information on how to use Factual Categories.

Attributes

Categories are assigned to a Factual Place in two distinct attributes, both of which are included in Factual's 25 core attributes.

No.AttributeDatatypeDescriptionExample
1category_idsArray (Integers)JSON array containing integer ID of the most granular category (or categories) of this entity[347,312]
2category_labelsArray (Arrays)Array of category labels. Each category label is represented by its own array of strings (i.e., an array of its hierarchical components).[["Social","Food and Dining","Restaurants"],["Social","Bars"]]
NOTE: The maximum number of categories that can be assigned to a POI record is three

Taxonomy

Factual Places includes a hierarchical taxonomy of categories from which each POI record is classified. The ten parent categories are:

  • Automotive
  • Community and Government
  • Healthcare
  • Landmarks
  • Retail
  • Businesses and Services
  • Social
  • Sports and Recreation
  • Transportation
  • Travel

See below for a table of the full taxonomy:

NOTE: We aim to preserve all existing category IDs. Therefore, when new categories are added to the taxonomy, they are inserted at the tail of the list. As such, you will see instances of related categories whose IDs are distant from one another.
IDCategory PathHealthcare1Restaurants2Hotels3
2Automotive
3Automotive > Car Appraisers
4Automotive > Car Dealers and Leasing
472Automotive > Car Dealers and Leasing > Car Dealers
5Automotive > Car Dealers and Leasing > Used Cars
6Automotive > Car Parts and Accessories
7Automotive > Car Wash and Detail
8Automotive > Classic and Antique Car
9Automotive > Maintenance and Repair
10Automotive > Maintenance and Repair > Oil and Lube
11Automotive > Maintenance and Repair > Smog Check
12Automotive > Maintenance and Repair > Tires
13Automotive > Maintenance and Repair > Transmissions
14Automotive > Motorcycles, Mopeds and Scooters
15Automotive > Motorcycles, Mopeds and Scooters > Repair
16Automotive > Motorcycles, Mopeds and Scooters > Sales
17Automotive > RVs and Motor Homes
18Automotive > Salvage Yards
19Automotive > Towing
20Community and Government
21Community and Government > Animal Shelters and Humane Societies
22Community and Government > Cemeteries
477Community and Government > City Halls
23Community and Government > Day Care and Preschools
24Community and Government > Disabled Persons Services
25Community and Government > Drug and Alcohol Services
26Community and Government > Education
27Community and Government > Education > Adult Education
28Community and Government > Education > Art Lessons and Schools
29Community and Government > Education > Colleges and Universities
30Community and Government > Education > Computer Training
31Community and Government > Education > Culinary Lessons and Schools
32Community and Government > Education > Driving Schools
33Community and Government > Education > Fraternities and Sororities
34Community and Government > Education > Primary and Secondary Schools
35Community and Government > Education > Tutoring and Educational Services
36Community and Government > Education > Vocational Schools
37Community and Government > Government Departments and Agencies
453Community and Government > Government Departments and Agencies > Embassies
38Community and Government > Government Lobbyists
39Community and Government > Housing Assistance and Shelters
40Community and Government > Law Enforcement and Public Safety
41Community and Government > Law Enforcement and Public Safety > Rescue Services
42Community and Government > Law Enforcement and Public Safety > Fire Stations
43Community and Government > Law Enforcement and Public Safety > Police Stations
44Community and Government > Libraries
45Community and Government > Military
46Community and Government > Military > Bases
47Community and Government > Organizations and Associations
48Community and Government > Organizations and Associations > Charities and Non-Profits
49Community and Government > Organizations and Associations > Environmental
50Community and Government > Organizations and Associations > Youth Organizations
51Community and Government > Post Offices
52Community and Government > Public and Social Services
53Community and Government > Religious
54Community and Government > Religious > Buddhist Temples
55Community and Government > Religious > Churches
56Community and Government > Religious > Hindu Temples
57Community and Government > Religious > Mosques
58Community and Government > Religious > Synagogues
59Community and Government > Senior Citizen Services
60Community and Government > Senior Citizen Services > Retirement
61Community and Government > Utility Companies
62Healthcare
63Healthcare > AIDS Resources
64Healthcare > Assisted Living Services
66Healthcare > Assisted Living Services > Facilities and Nursing Homes
65Healthcare > Home Health Care Services
67Healthcare > Blood Banks and Centers
68Healthcare > Chiropractors
69Healthcare > Dentists
70Healthcare > Emergency Services
71Healthcare > Emergency Services > Ambulance
72Healthcare > Holistic, Alternative and Naturopathic Medicine
73Healthcare > Holistic, Alternative and Naturopathic Medicine > Acupuncture
74Healthcare > Hospitals, Clinics and Medical Centers
75Healthcare > Medical Supplies and Labs
76Healthcare > Mental Health
77Healthcare > Mental Health > Counseling and Therapy
78Healthcare > Mental Health > Psychologists
79Healthcare > Nurses
475Healthcare > Other Healthcare Professionals
80Healthcare > Pharmacies
81Healthcare > Physical Therapy and Rehabilitation
82Healthcare > Physical Therapy and Rehabilitation > Sports Medicine
83Healthcare > Physicians
84Healthcare > Physicians > Anesthesiologists
85Healthcare > Physicians > Cardiologists
86Healthcare > Physicians > Dermatologists
87Healthcare > Physicians > Ear, Nose and Throat
88Healthcare > Physicians > Family Medicine
89Healthcare > Physicians > Gastroenterologists
90Healthcare > Physicians > General Surgery
91Healthcare > Physicians > Internal Medicine
92Healthcare > Physicians > Neurologists
93Healthcare > Physicians > Obstetricians and Gynecologists
94Healthcare > Physicians > Oncologists
95Healthcare > Physicians > Ophthalmologists
476Healthcare > Physicians > Oral Surgeons
96Healthcare > Physicians > Orthopedic Surgeons
97Healthcare > Physicians > Pathologists
98Healthcare > Physicians > Pediatricians
99Healthcare > Physicians > Plastic Surgeons
100Healthcare > Physicians > Psychiatrists
101Healthcare > Physicians > Radiologists
102Healthcare > Physicians > Respiratory
103Healthcare > Physicians > Urologists
441Healthcare > Physicians > Geriatrics
104Healthcare > Podiatrists
105Healthcare > Pregnancy and Sexual Health
106Healthcare > Weight Loss and Nutritionists
466Healthcare > Optometrist
107Landmarks
108Landmarks > Buildings and Structures
109Landmarks > Gardens
110Landmarks > Historic and Protected Sites
111Landmarks > Monuments and Memorials
112Landmarks > Natural
113Landmarks > Natural > Beaches
114Landmarks > Natural > Mountains
115Landmarks > Natural > Forests
116Landmarks > Natural > Lakes
117Landmarks > Natural > Rivers
118Landmarks > Parks
119Landmarks > Parks > Natural Parks
120Landmarks > Parks > Picnic Areas
121Landmarks > Parks > Playgrounds
122Landmarks > Parks > Urban Parks
461Landmarks > Parks > Dog Parks
123Retail
124Retail > Adult
125Retail > Antiques
126Retail > Arts and Crafts
127Retail > Auctions
128Retail > Beauty Products
129Retail > Bicycles
130Retail > Bookstores
484Retail > Cannabis Stores
131Retail > Cards and Stationery
132Retail > Children
480Retail > Comic Book Stores
133Retail > Computers and Electronics
134Retail > Computers and Electronics > Cameras
135Retail > Computers and Electronics > Mobile Phones
136Retail > Computers and Electronics > Video Games
137Retail > Construction Supplies
138Retail > Convenience Stores
139Retail > Costumes
140Retail > Dance and Music
141Retail > Department Stores
142Retail > Fashion
143Retail > Fashion > Clothing and Accessories
144Retail > Fashion > Jewelry and Watches
145Retail > Fashion > Shoes
146Retail > Fashion > Swimwear
147Retail > Flea Markets
148Retail > Florists
149Retail > Food and Beverage
150Retail > Food and Beverage > Beer, Wine and Spirits
151Retail > Food and Beverage > Candy Stores
152Retail > Food and Beverage > Cheese
153Retail > Food and Beverage > Chocolate
154Retail > Food and Beverage > Farmers' Markets
155Retail > Food and Beverage > Health and Diet Food
156Retail > Food and Beverage > Kosher
443Retail > Food and Beverage > Meat and Seafood
157Retail > Furniture and Decor
158Retail > Gift and Novelty
159Retail > Glasses
468Retail > Hardware Stores
160Retail > Hobby and Collectibles
161Retail > Luggage
162Retail > Music, Video and DVD
163Retail > Newsstands
164Retail > Nurseries and Garden Centers
165Retail > Outlet
166Retail > Pawn Shops
167Retail > Pets
470Retail > Pets > Grooming
469Retail > Pets > Pet Sitting and Boarding
471Retail > Pets > Pet Supplies
168Retail > Photos and Frames
169Retail > Shopping Centers and Malls
170Retail > Sporting Goods
171Retail > Supermarkets and Groceries
172Retail > Tobacco
483Retail > Tobacco > Vaporizer Shops
173Retail > Toys
174Retail > Vintage and Thrift
175Retail > Warehouses and Wholesale Stores
176Retail > Wedding and Bridal
248Retail > Home Appliances
250Retail > Housewares
442Retail > Discount Stores
444Retail > Office Supplies
445Retail > Party Supplies
177Businesses and Services
178Businesses and Services > Business and Strategy Consulting
179Businesses and Services > Industrial Machinery and Vehicles
180Businesses and Services > Logging and Sawmills
181Businesses and Services > Metals
182Businesses and Services > Packaging
183Businesses and Services > Petroleum
184Businesses and Services > Plastics
185Businesses and Services > Refrigeration and Ice
186Businesses and Services > Rubber
187Businesses and Services > Scientific
188Businesses and Services > Security and Safety
189Businesses and Services > Telecommunication Services
190Businesses and Services > Textiles
191Businesses and Services > Water and Waste Management
192Businesses and Services > Welding
193Businesses and Services > Advertising and Marketing
194Businesses and Services > Advertising and Marketing > Advertising Agencies and Media Buyers
195Businesses and Services > Advertising and Marketing > Creative Services
196Businesses and Services > Advertising and Marketing > Direct Mail and Email Marketing Services
197Businesses and Services > Advertising and Marketing > Market Research and Consulting
198Businesses and Services > Advertising and Marketing > Online Advertising
199Businesses and Services > Advertising and Marketing > Print, TV, Radio and Outdoor Advertising
200Businesses and Services > Advertising and Marketing > Promotional Items
201Businesses and Services > Advertising and Marketing > Public Relations
202Businesses and Services > Advertising and Marketing > Search Engine Marketing and Optimization
203Businesses and Services > Advertising and Marketing > Writing, Copywriting and Technical Writing
204Businesses and Services > Agriculture and Forestry
205Businesses and Services > Art Restoration
206Businesses and Services > Audiovisual
207Businesses and Services > Automation and Control Systems
208Businesses and Services > Chemicals and Gasses
209Businesses and Services > Computers
210Businesses and Services > Corporate HQ
211Businesses and Services > Electrical Equipment
212Businesses and Services > Employment Agencies
213Businesses and Services > Engineering
214Businesses and Services > Entertainment
215Businesses and Services > Entertainment > Media
216Businesses and Services > Equipment Rental
217Businesses and Services > Events and Event Planning
465Businesses and Services > Events and Event Planning > Convention Centers
219Businesses and Services > Financial
220Businesses and Services > Financial > Accounting and Bookkeeping
221Businesses and Services > Financial > Banking and Finance
218Businesses and Services > Financial > Banking and Finance > ATMs
473Businesses and Services > Financial > Banking and Finance > Banks and Credit Unions
222Businesses and Services > Financial > Business Brokers and Franchises
223Businesses and Services > Financial > Check Cashing
224Businesses and Services > Financial > Collections
225Businesses and Services > Financial > Financial Planning and Investments
226Businesses and Services > Financial > Fund Raising
227Businesses and Services > Financial > Loans and Mortgages
228Businesses and Services > Financial > Stock Brokers
229Businesses and Services > Financial > Student Aid and Grants
230Businesses and Services > Food and Beverage
231Businesses and Services > Food and Beverage > Catering
232Businesses and Services > Food and Beverage > Distribution
233Businesses and Services > Funeral Services
234Businesses and Services > Geological
235Businesses and Services > Home Improvement
236Businesses and Services > Home Improvement > Architects
237Businesses and Services > Home Improvement > Carpenters
238Businesses and Services > Home Improvement > Carpet and Flooring
239Businesses and Services > Home Improvement > Contractors
240Businesses and Services > Home Improvement > Contractors > Bathrooms
241Businesses and Services > Home Improvement > Contractors > Deck and Patio
242Businesses and Services > Home Improvement > Contractors > Sewer
243Businesses and Services > Home Improvement > Doors and Windows
244Businesses and Services > Home Improvement > Electricians
245Businesses and Services > Home Improvement > Fences, Fireplaces and Garage Doors
246Businesses and Services > Home Improvement > Hardware and Services
247Businesses and Services > Home Improvement > Heating, Ventilating and Air Conditioning
249Businesses and Services > Home Improvement > Home Inspection Services
251Businesses and Services > Home Improvement > Interior Design
252Businesses and Services > Home Improvement > Kitchens
253Businesses and Services > Home Improvement > Landscaping and Gardeners
254Businesses and Services > Home Improvement > Lighting Fixtures
256Businesses and Services > Home Improvement > Movers
257Businesses and Services > Home Improvement > Painting
258Businesses and Services > Home Improvement > Pest Control
259Businesses and Services > Home Improvement > Plumbing
260Businesses and Services > Home Improvement > Pools and Spas
261Businesses and Services > Home Improvement > Roofers
263Businesses and Services > Home Improvement > Swimming Pool Maintenance and Services
264Businesses and Services > Home Improvement > Tree Service
265Businesses and Services > Home Improvement > Upholstery
262Businesses and Services > Storage
266Businesses and Services > Human Resources
267Businesses and Services > Import and Export
268Businesses and Services > Leather
269Businesses and Services > Legal
474Businesses and Services > Legal > Attorneys and Law Offices
270Businesses and Services > Legal > Credit Counseling and Bankruptcy Services
271Businesses and Services > Legal > Immigration
448Businesses and Services > Legal > Notary
272Businesses and Services > Insurance
273Businesses and Services > Machine Shops
274Businesses and Services > Management
275Businesses and Services > Manufacturing
276Businesses and Services > Paper
277Businesses and Services > Personal Care
278Businesses and Services > Personal Care > Dry Cleaning, Ironing and Laundry
279Businesses and Services > Personal Care > Hair Removal
280Businesses and Services > Personal Care > Beauty Salons and Barbers
281Businesses and Services > Personal Care > Manicures and Pedicures
282Businesses and Services > Personal Care > Massage Clinics and Therapists
283Businesses and Services > Personal Care > Piercing
284Businesses and Services > Personal Care > Skin Care
285Businesses and Services > Personal Care > Spas
286Businesses and Services > Personal Care > Tanning Salons
287Businesses and Services > Personal Care > Tattooing
288Businesses and Services > Printing, Copying and Signage
289Businesses and Services > Professional Cleaning
290Businesses and Services > Publishing
291Businesses and Services > Real Estate
255Businesses and Services > Real Estate > Mobile Homes
292Businesses and Services > Real Estate > Property Management
293Businesses and Services > Real Estate > Real Estate Agents
294Businesses and Services > Real Estate > Real Estate Appraiser
295Businesses and Services > Real Estate > Real Estate Development and Title Companies
296Businesses and Services > Real Estate > Apartments, Condos, and Houses
297Businesses and Services > Real Estate > Boarding Houses
298Businesses and Services > Real Estate > Building and Land Surveyors
299Businesses and Services > Real Estate > Commercial Real Estate
300Businesses and Services > Real Estate > Corporate Housing
301Businesses and Services > Renewable Energy
302Businesses and Services > Repair Services
303Businesses and Services > Shipping, Freight, and Material Transportation
304Businesses and Services > Tailors
305Businesses and Services > Veterinarians
307Businesses and Services > Wholesale
446Businesses and Services > Career Counseling
447Businesses and Services > Construction
449Businesses and Services > Photography
450Businesses and Services > Translation Services
460Businesses and Services > Technology
306Businesses and Services > Technology > Web Design and Development
454Businesses and Services > Technology > Infrastructure
455Businesses and Services > Technology > Mobile
456Businesses and Services > Technology > Advertising
308Social
309Social > Arts
310Social > Arts > Art Dealers and Galleries
311Social > Arts > Museums
312Social > Bars
313Social > Bars > Hotel Lounges
314Social > Bars > Jazz and Blues Cafes
315Social > Bars > Sports Bars
316Social > Bars > Wine Bars
317Social > Entertainment
318Social > Entertainment > Adult Entertainment
319Social > Entertainment > Amusement Parks
320Social > Entertainment > Billiard and Pool
321Social > Entertainment > Bingo
322Social > Entertainment > Bowling
323Social > Entertainment > Carnivals
324Social > Entertainment > Casinos and Gaming
325Social > Entertainment > Circuses
481Social > Entertainment > Comedy Clubs
326Social > Entertainment > Dance Halls and Saloons
327Social > Entertainment > Fairgrounds and Rodeos
328Social > Entertainment > Go Carts
329Social > Entertainment > Hookah Lounges
330Social > Entertainment > Karaoke
331Social > Entertainment > Miniature Golf
332Social > Entertainment > Movie Theatres
333Social > Entertainment > Music and Show Venues
334Social > Entertainment > Night Clubs
335Social > Entertainment > Party Centers
336Social > Entertainment > Psychics and Astrologers
337Social > Entertainment > Ticket Sales
463Social > Entertainment > Arcades
338Social > Food and Dining
339Social > Food and Dining > Bagels and Donuts
340Social > Food and Dining > Bakeries
341Social > Food and Dining > Breweries
342Social > Food and Dining > Cafes, Coffee and Tea Houses
482Social > Food and Dining > Cafes, Coffee and Tea Houses > Bubble Tea
343Social > Food and Dining > Dessert
344Social > Food and Dining > Ice Cream Parlors
345Social > Food and Dining > Internet Cafes
346Social > Food and Dining > Juice Bars and Smoothies
347Social > Food and Dining > Restaurants
348Social > Food and Dining > Restaurants > American
349Social > Food and Dining > Restaurants > Barbecue
350Social > Food and Dining > Restaurants > Buffets
351Social > Food and Dining > Restaurants > Burgers
352Social > Food and Dining > Restaurants > Chinese
353Social > Food and Dining > Restaurants > Delis
354Social > Food and Dining > Restaurants > Diners
355Social > Food and Dining > Restaurants > Fast Food
356Social > Food and Dining > Restaurants > French
357Social > Food and Dining > Restaurants > Indian
358Social > Food and Dining > Restaurants > Italian
359Social > Food and Dining > Restaurants > Japanese
360Social > Food and Dining > Restaurants > Korean
361Social > Food and Dining > Restaurants > Mexican
362Social > Food and Dining > Restaurants > Middle Eastern
363Social > Food and Dining > Restaurants > Pizza
364Social > Food and Dining > Restaurants > Seafood
365Social > Food and Dining > Restaurants > Steakhouses
366Social > Food and Dining > Restaurants > Sushi
367Social > Food and Dining > Restaurants > Thai
368Social > Food and Dining > Restaurants > Vegan and Vegetarian
457Social > Food and Dining > Restaurants > Asian
458Social > Food and Dining > Restaurants > Food Trucks
464Social > Food and Dining > Restaurants > International
369Social > Country Clubs
370Social > Wineries and Vineyards
371Social > Zoos, Aquariums and Wildlife Sanctuaries
372Sports and Recreation
373Sports and Recreation > Athletic Fields
374Sports and Recreation > Baseball
375Sports and Recreation > Baseball > Batting Ranges
376Sports and Recreation > Basketball
377Sports and Recreation > Combat Sports
378Sports and Recreation > Cycling
379Sports and Recreation > Dance
380Sports and Recreation > Equestrian
381Sports and Recreation > Football
382Sports and Recreation > Golf
451Sports and Recreation > Golf > Golf Courses
383Sports and Recreation > Gun Ranges
384Sports and Recreation > Gymnastics
385Sports and Recreation > Gyms and Fitness Centers
386Sports and Recreation > Hockey
387Sports and Recreation > Outdoors
388Sports and Recreation > Outdoors > Campgrounds and RV Parks
389Sports and Recreation > Outdoors > Hiking
390Sports and Recreation > Outdoors > Hot Air Balloons
391Sports and Recreation > Outdoors > Hunting and Fishing
392Sports and Recreation > Outdoors > Rock Climbing
393Sports and Recreation > Outdoors > Skydiving
394Sports and Recreation > Paintball
395Sports and Recreation > Personal Trainers
396Sports and Recreation > Race Tracks
397Sports and Recreation > Racquet Sports
398Sports and Recreation > Racquet Sports > Racquetball
399Sports and Recreation > Racquet Sports > Tennis
400Sports and Recreation > Recreation Centers
401Sports and Recreation > Running
402Sports and Recreation > Skating
403Sports and Recreation > Snow Sports
404Sports and Recreation > Soccer
405Sports and Recreation > Sports Clubs
406Sports and Recreation > Stadiums and Arenas
407Sports and Recreation > Swimming Pools
408Sports and Recreation > Water Sports
409Sports and Recreation > Water Sports > Boating
410Sports and Recreation > Water Sports > Canoes and Kayaks
411Sports and Recreation > Water Sports > Rafting
412Sports and Recreation > Water Sports > Scuba Diving
413Sports and Recreation > Water Sports > Swimming
452Sports and Recreation > Water Sports > Surfing
414Sports and Recreation > Yoga and Pilates
415Transportation
416Transportation > Airlines and Aviation Services
417Transportation > Fuel Stations
479Transportation > Fuel Stations > Electric Vehicle Charging Stations
418Transportation > Parking
419Transportation > Public Transportation Services
420Transportation > Taxi and Car Services
421Transportation > Taxi and Car Services > Car and Truck Rentals
422Transportation > Taxi and Car Services > Charter Buses
423Transportation > Taxi and Car Services > Limos and Chauffeurs
424Transportation > Transport Hubs
425Transportation > Transport Hubs > Airports
462Transportation > Transport Hubs > Airports > International Airports
478Transportation > Transport Hubs > Airports > Private Airports
426Transportation > Transport Hubs > Bus Stations
427Transportation > Transport Hubs > Heliports
428Transportation > Transport Hubs > Ports
429Transportation > Transport Hubs > Rail Stations
459Transportation > Rest Areas
430Travel
431Travel > Cruises
432Travel > Lodging
433Travel > Lodging > Bed and Breakfasts
434Travel > Lodging > Cottages and Cabins
435Travel > Lodging > Hostels
436Travel > Lodging > Hotels and Motels
437Travel > Lodging > Lodges and Vacation Rentals
438Travel > Lodging > Resorts
439Travel > Tourist Information and Services
440Travel > Travel Agents and Tour Operators

▲ Back to top of taxonomy

SIC and NAICS Mappings

Many developers may be employing Standard Industrial Classification (SIC) codes, or their more recent replacement, North American Industry Classification System (NAICS) codes. As such, we have provided a mapping between Factual category IDs and these Government standards.

The following are tab-delimited .tsv files, and can be opened in Excel:

FAQ

Please see the categories section of our Places FAQ.

------------------------------------------------------------------------------------------------------------

1 Categories that comprise Factual Healthcare Providers

2 Categories that comprise Factual Restaurants

3 Categories that comprise Factual Hotels

Updated 3 months ago

Categories


Suggested Edits are limited on API Reference Pages

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