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    

Core Attributes

Factual Places comes with 25 core attributes. See below for a comprehensive list. For additional attributes that can be licensed for an additional fee, please see our page on extended attributes.

No.AttributeDatatypeDescription
1factual_idStringUnique identifier
2nameStringBusiness/POI name
3addressStringAddress number and street name
4address_extendedStringAdditional address, incl. suite numbers
5po_boxStringPO Box
6localityStringCity, town or equivalent
7regionStringState, province, territory, or equivalent
8post_townStringTown/place employed in postal addressing. May not reflect the formal geographic location of a place.
9admin_regionStringAdditional sub-division. Usually, but not always, a country sub-division (e.g., Scotland).
10postcodeStringPostcode or equivalent (zipcode in US)
11countryStringISO 3166-1 alpha-2 country code
12telStringTelephone number with local formatting
13faxStringFax number in local formatting
14latitudeDecimalLatitude in decimal degrees (WGS84 datum). Value will not exceed 6 decimal places.
15longitudeDecimalLongitude in decimal degrees (WGS84 datum). Value will not exceed 6 decimal places.
16neighborhoodArray (String)The neighborhood(s) or other informal geography in which this entity is found
17websiteStringAuthority page (official website)
18emailStringPrimary contact email address of organization
19category_idsArray (Integer)Category IDs that classify this entity
20category_labelsArray (Arrays)Category labels that describe the category branch
21chain_nameStringLabel indicating which chain (brand or franchise) this entity is a member of
22chain_idStringUnique ID indicating which chain (brand or franchise) this entity is a member of
23hoursStringJSON representation of hours of operation
24hours_displayStringString representation of hours of operation
25existenceDecimalScore between 0.0 and 1.0 (0.1 increments) representing confidence that the record is real, open, and not a duplicate

Updated about a year ago

Core Attributes


Suggested Edits are limited on API Reference Pages

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