Working With Factual Global Places

Factual’s Global Places database has 65+ 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. As noted, diffs are currently available for specified tables. We’re working to make diffs available for all countries ASAP.

ISO Country code ▾ Country Rows1 Direct API endpoint2 Supports Diffs?3 Notes
All Countries 65+ million /t/places All countries in a single table
us United States 23,153,377 /t/places-us Y
cn China 12,915,716 /t/places-cn Y
de Germany 3,174,045 /t/places-de Y
fr France 4,362,053 /t/places-fr Y
jp Japan 5,157,480 /t/places-jp Y
gb United Kingdom 2,176,669 /t/places-gb Y
it Italy 2,160,568 /t/places-it Y
ca Canada 1,861,347 /t/places-ca Y
br Brazil 1,732,724 /t/places-br Y
es Spain 1,633,382 /t/places-es Y
au Australia 1,308,201 /t/places-au Y
se Sweden 849,995 /t/places-se Y
tw Taiwan 1,181,747 /t/places-tw Y
mx Mexico 427,286 /t/places-mx Y
ch Switzerland 711,976
ru Russia 594,529 /t/places-ru Y
at Austria 544,605 /t/places-at Y
dk Denmark 513,609
pt Portugal 665,410 /t/places-pt Y
no Norway 403,458
kr South Korea 380,599 /t/places-kr Y
fi Finland 377,121
nl Netherlands 352,340
be Belgium 258,169
ar Argentina 229,735
ie Ireland 229,352
sg Singapore 200,326 /t/places-sg Y
pl Poland 206,545
tr Turkey 176,684 /t/places-tr Y
hk Hong Kong 182,487 /t/places-hk Y
my Malaysia 157,652
in India 345,984 /t/places-in Y
id Indonesia 276,296 /t/places-id Y
cl Chile 110,782
th Thailand 108,174 /t/places-th Y
ph Philippines 87,114 /t/places-ph Y
nz New Zealand 84,650 /t/places-nz Y
co Colombia 82,190
hu Hungary 75,114
il Israel 67,877 /t/places-il Y
za South Africa 102,682
vn Vietnam 44,350
hr Croatia 43,942
cz Czech Republic 33,903
pr Puerto Rico 29,205
lu Luxembourg 28,574
ve Venezuela 28,439
pe Peru 24,612
gr Greece 24,613
eg Egypt 12,349

1 Row counts per country as of Mar 27, 2014
2 Use this endpoint for any diffs API calls, or to avoid the performance penalty of determining what country the data you are searching for is in if you already know it.
3 Diffs API access is only available to developers with download licenses. Contact Factual for licensing information.

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 (base on my lat/lng):
http://api.v3.factual.com/t/places?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?q=starbucks&filters={"$and":[{"locality":"santa monica"},{"region":"ca"},{"country":"us"}]}
Find a bar in Santa Monica
http://api.v3.factual.com/t/places?filters={"$and":[{"category_ids":312},{"locality":"santa monica"},{"region":"ca"},{"country":"us"}]}

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)
  • 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.