Working With Factual Global Places

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

Explore the data through our interactive data preview.


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 Real-time Writes?3 Notes
All Countries 75+ million /t/places All countries in a single table
us United States 19,962,549 /t/places-us Y
cn China 15,864,049 /t/places-cn Y
de Germany 2,827,767 /t/places-de Y
fr France 3,100,634 /t/places-fr Y
jp Japan 6,705,636 /t/places-jp Y
gb United Kingdom 3,209,157 /t/places-gb Y
it Italy 3,984,367 /t/places-it Y
ca Canada 2,057,868 /t/places-ca Y
br Brazil 3,104,096 /t/places-br Y
es Spain 3,146,956 /t/places-es Y
au Australia 1,494,605 /t/places-au Y
se Sweden 731,098 /t/places-se Y
tw Taiwan 1,154,884 /t/places-tw Y
mx Mexico 627,866 /t/places-mx Y
ch Switzerland 680,458
ru Russia 749,983 /t/places-ru Y
at Austria 675,500 /t/places-at Y
dk Denmark 512,864
pt Portugal 983,099 /t/places-pt Y
no Norway 403,348
kr South Korea 639,044 /t/places-kr Y
fi Finland 376,278
nl Netherlands 351,573
be Belgium 257,702
ar Argentina 229,337
ie Ireland 218,373
sg Singapore 235,474 /t/places-sg Y
pl Poland 206,040
tr Turkey 162,146 /t/places-tr Y
hk Hong Kong 208,783 /t/places-hk Y
my Malaysia 156,722
in India 399,484 /t/places-in Y
id Indonesia 456,510 /t/places-id Y
cl Chile 110,112
th Thailand 223,822 /t/places-th Y
ph Philippines 133,211 /t/places-ph Y
nz New Zealand 211,535 /t/places-nz Y
co Colombia 82,076
hu Hungary 74,884
il Israel 142,197 /t/places-il Y
za South Africa 213,527
vn Vietnam 44,272
hr Croatia 43,745
cz Czech Republic 33,684
pr Puerto Rico 29,144
lu Luxembourg 28,535
ve Venezuela 28,420
pe Peru 24,450
gr Greece 24,384
eg Egypt 12,113

1 Row counts per country as of Dec 18, 2014 and use the default existence threshold.
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 (within 5 km of on my lat/lng):{"$circle":{"$center":[34.06021,-118.41828],"$meters":5000}}
Find a Starbucks in Santa Monica, CA, USA{"$and":[{"locality":"santa monica"},{"region":"ca"}]}
Find an Italian Restaurant near me{"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{"$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 direct 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.