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.


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 65+ million /t/places All countries in a single table
us United States 16,761,561 /t/places-us Y
cn China 16,352,815 /t/places-cn Y
de Germany 2,827,910 /t/places-de Y
fr France 3,245,772 /t/places-fr Y
jp Japan 6,956,171 /t/places-jp Y
gb United Kingdom 3,209,230 /t/places-gb Y
it Italy 3,984,374 /t/places-it Y
ca Canada 2,057,880 /t/places-ca Y
br Brazil 3,104,099 /t/places-br Y
es Spain 3,151,337 /t/places-es Y
au Australia 1,491,179 /t/places-au Y
se Sweden 699,691 /t/places-se Y
tw Taiwan 1,169,843 /t/places-tw Y
mx Mexico 619,656 /t/places-mx Y
ch Switzerland 674,167
ru Russia 749,988 /t/places-ru Y
at Austria 679,807 /t/places-at Y
dk Denmark 656,881
pt Portugal 982,720 /t/places-pt Y
no Norway 492,074
kr South Korea 639,044 /t/places-kr Y
fi Finland 376,251
nl Netherlands 3,511
be Belgium 257,378
ar Argentina 222,345
ie Ireland 229,009
sg Singapore 235,905 /t/places-sg Y
pl Poland 206,030
tr Turkey 175,382 /t/places-tr Y
hk Hong Kong 209,417 /t/places-hk Y
my Malaysia 156,694
in India 399,498 /t/places-in Y
id Indonesia 464,385 /t/places-id Y
cl Chile 27,815
th Thailand 227,028 /t/places-th Y
ph Philippines 131,266 /t/places-ph Y
nz New Zealand 210,248 /t/places-nz Y
co Colombia 81,186
hu Hungary 73,605
il Israel 142,062 /t/places-il Y
za South Africa 213,530
vn Vietnam 44,272
hr Croatia 43,428
cz Czech Republic 33,142
pr Puerto Rico 29,138
lu Luxembourg 27,915
ve Venezuela 28,417
pe Peru 24,139
gr Greece 23,979
eg Egypt 12,111

1 Row counts per country as of Jan 28, 2015 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.