Working With Factual Global Places

Factual’s Global Places database has 90+ million entities in 50 countries, all accessible through our unified Global Places API.

Explore the data through our interactive data preview.

Schema

The schema for the global place data can be found here, or you can access it programmatically. You can find the complete list of categories used in our global place data here

Supported Countries

The following countries are supported in Factual’s place data.

ISO Country code ▾ Country Rows1 Read API endpoint2 Crosswalk API endpoint Notes
All Countries 90+ million places All countries in a single table2
us United States 21,171,531 places-us crosswalk-us
cn China 11,713,783 places-cn crosswalk-cn
jp Japan 6,843,146 places-jp crosswalk-jp
de Germany 6,178,709 places-de crosswalk-de
it Italy 4,104,750 places-it crosswalk-it
fr France 4,880,046 places-fr crosswalk-fr
es Spain 2,858,620 places-es crosswalk-es
gb United Kingdom 3,552,443 places-gb crosswalk-gb
br Brazil 3,378,748 places-br crosswalk-br
ca Canada 2,124,158 places-ca crosswalk-ca
au Australia 1,989,065 places-au crosswalk-au
kr South Korea 2,741,812 places-kr crosswalk-kr
pt Portugal 1,351,757 places-pt crosswalk-pt
tw Taiwan 729,641 places-tw crosswalk-tw
ch Switzerland 720,186 places-ch crosswalk-ch
no Norway 923,373 places-no crosswalk-no
ru Russia 804,317 places-ru crosswalk-ru
se Sweden 853,033 places-se crosswalk-se
at Austria 770,009 places-at crosswalk-at
mx Mexico 1,726,254 places-mx crosswalk-mx
dk Denmark 575,380 places-dk crosswalk-dk
za South Africa 538,132 places-za crosswalk-za
in India 600,036 places-in crosswalk-in
id Indonesia 1,018,039 places-id crosswalk-id
fi Finland 524,092 places-fi crosswalk-fi
nl Netherlands 1,459,474 places-nl crosswalk-nl
be Belgium 563,723 places-be crosswalk-be
th Thailand 286,923 places-th crosswalk-th
ph Philippines 484,178 places-ph crosswalk-ph
sg Singapore 358,345 places-sg crosswalk-sg
ar Argentina 363,105 places-ar crosswalk-ar
hk Hong Kong 291,396 places-hk crosswalk-hk
ie Ireland 347,205 places-ie crosswalk-ie
pl Poland 1,498,139 places-pl crosswalk-pl
tr Turkey 658,426 places-tr crosswalk-tr
nz New Zealand 224,013 places-nz crosswalk-nz
my Malaysia 629,128 places-my crosswalk-my
il Israel 138,942 places-il crosswalk-il
cl Chile 151,878 places-cl crosswalk-cl
co Colombia 517,110 places-co crosswalk-co
hu Hungary 172,553 places-hu crosswalk-hu
vn Vietnam 183,612 places-vn crosswalk-vn
hr Croatia 190,459 places-hr crosswalk-hr
cz Czech Republic 213,092 places-cz crosswalk-cz
pr Puerto Rico 78,936 places-pr crosswalk-pr
lu Luxembourg 44,973 places-lu crosswalk-lu
ve Venezuela 30,042 places-ve crosswalk-ve
pe Peru 128,467 places-pe crosswalk-pe
gr Greece 176,199 places-gr crosswalk-gr
eg Egypt 224,309 places-eg crosswalk-eg

1 Row counts reflect Mar 25, 2016 data using the default existence threshold.

2 Always use the direct endpoint (e.g., places-us) if you know the country you are searching against, if available. The direct endpoints are much higher performance. Countries without a direct endpoint shown must be accessed by the global endpoint (places).

Syntax and Examples

You can query global places with a single, simple (but powerful) API call. Note that all of the examples are shown below without URL encoding for clarity. In practice, you’ll need to encode each example when making requests.

Find a Starbucks near me (within 5 km of on my lat/lng):
http://api.v3.factual.com/t/places-us?q=starbucks&geo={"$circle":{"$center":[34.06021,-118.41828],"$meters":5000}}
Find a Starbucks in Santa Monica, CA, USA
http://api.v3.factual.com/t/places-us?q=starbucks&filters={"$and":[{"locality":"santa monica"},{"region":"ca"}]}
Find an Italian Restaurant near me
http://api.v3.factual.com/t/places-us?filters={"category_ids":{"$includes":358}}&geo={"$circle":{"$center":[34.06021,-118.41828],"$meters":5000}}

There is a comprehensive list of categories, and their associated Ids.

Find a Restauraunt or Bar in Santa Monica
http://api.v3.factual.com/t/places-us?filters={"$and":[{"category_ids":{"$includes_any":[312,347]}},{"locality":"santa monica"},{"region":"ca"}]}

Note that including a mid-level category like “Social > Food and Dining > Restaurants” (347) will implicitly include all nested categories (348-368).

Make your queries efficient

You’ll find that your queries will return significantly faster if you either:

  • Include a lat/lng in your query (using a geo filter)
  • Specify a country code in your query (using a row filter) or using the country-specific read API endpoint for the country you are searching.
  • Provide enough detail that the place you are looking for can be uniquely identified. For example, filtering on a phone number or Factual Id.

Note: If you make too many inefficient queries in a short period, you may find your API calls periodically throttled.

Using the API to correct data.

Factual has a robust set of Write APIs for contributing new businesses, updating existing businesses and flagging data problems. There are many examples in the Write API documentation.