Crosswalk for Places

Crosswalk for Places enables you to translate between Factual IDs, third party IDs, and URLs that represent the same entity across the internet. You can browse Crosswalk data using our data preview.

Syntax and Examples

API access to Crosswalk for Places is available from /t/crosswalk:

http://api.v3.factual.com/t/crosswalk

Calls to this endpoint will return all attributes with non-null values from the schema below. Using syntax identical to Factual’s Core API read call, you can query Crosswalk data using parametric search using row filters or using full-text search. All examples below are shown with URL encoding for clarity. In practice, you will need to URL encode all GET parameters.

Lookup the Yelp Crosswalk entry for The Stand, using on its Yelp page

http://api.v3.factual.com/t/crosswalk?filters={"url":"http://www.yelp.com/biz/the-stand-los-angeles-6"}

Alternately, lookup The Stand’s Crosswalk entry using its Foursquare ID:
http://api.v3.factual.com/t/crosswalk?filters={"namespace":"foursquare","namespace_id":"4ae4df6df964a520019f21e3"}

Find all Crosswalk entries that Factual has for The Stand:
http://api.v3.factual.com/t/crosswalk?filters={"factual_id":"57ddbca5-a669-4fcf-968f-a1c8210a479a"}

Find the OpenMenu Crosswalk entry for The Stand, by Factual ID:
http://api.v3.factual.com/t/crosswalk?filters={"factual_id":"57ddbca5-a669-4fcf-968f-a1c8210a479a","namespace":"openmenu"}

Using our response for OpenMenu, you can now get The Stand’s menu from OpenTable directly: http://openmenu.com/menu/2121b85c-15bb-11e0-b40e-0018512e6b26. Similarly, you could use it’s Foursquare ID to check into it or it’s OpenTable ID to make a reservation there.
Search for all Container Store Yelp pages:
http://api.v3.factual.com/t/crosswalk?q=the container store&filters={"namespace":"yelp"}

Schema

The schema for Crosswalk for Places is here.

Namespaces Supported

Below is a list of the supported Namespaces in Crosswalk. To help you get a sense for how you can incorporate these third party platforms into your app, we’ve provided links to their respective developer documentation when appropriate.

Namespace Includes Namespace ID? API Documentation for this service Deprecated*
allmenus yes
allpages
aol
bitehunter yes
city-of-hotels
citygrid yes http://www.citygridmedia.com/developer/
citysearch http://www.citygridmedia.com/developer/
cliq yes
dexknows
eventful yes http://api.eventful.com/
facebook yes https://developers.facebook.com/
foodfinder yes
foursquare yes https://developer.foursquare.com/
geoplanet yes http://developer.yahoo.com/geo/geoplanet/
gogobot yes http://www.gogobot.com/affiliates
google_plus
greatschools http://www.greatschools.org/api/registration.page
grubhub yes
hotels yes
hotelscombined yes http://www.hotelscombined.com/Affiliates.aspx
hunch yes http://hunch.com/developers/v1/
insiderpages
instagram_handle
locu yes
manta
menuism
menumob yes
menupages
menupix
merchantcircle http://api.merchantcircle.com/api/v1/docs
openmenu yes http://openmenu.com/
opentable yes http://www.opentable.com/info/affiliates.aspx
patch
restaurants
retailigence yes http://www.retailigence.com/developers/
seamless http://www.seamless.com/business-development/developers/
singleplatform yes
songkick yes http://www.songkick.com/developer
square
stubhub
superpages
tripadvisor http://www.tripadvisor.com/APIAccessSupport
trustyou yes
twitter yes https://dev.twitter.com
urbanspoon
wikipedia
yahoolocal
yellowbook
yellowpages
yelp limited http://www.yelp.com/developers/documentation
zagat

*Factual retains, but does not maintain, deprecated namespaces