Places Crosswalk

Places Crosswalk enables you to translate between Factual IDs, third party IDs, and URLs that represent the same entity across the internet.

Syntax

Places Crosswalk data is accessed through country-specific endpoints in the format /t/crosswalk-ISO two letter country code using the read API.

For example, the endpoint for US Crosswalk data is:

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

  • A list of international Places Crosswalk endpoints is available here.
  • Calls to Places Crosswalk endpoints will return all attributes with non-null values from the schema below.

Examples

All examples, below, are shown without URL encoding for clarity. In practice, you will need to URL encode all GET parameters.

Find the Yelp Crosswalk entry for The Stand, using its Yelp page:

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

Find all Places Crosswalk entries that Factual has for The Stand (based on the ID returned from the previous example):
http://api.v3.factual.com/t/crosswalk-us?filters={"factual_id":"57ddbca5-a669-4fcf-968f-a1c8210a479a"}

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

Search for all Container Store Yelp pages:
http://api.v3.factual.com/t/crosswalk-us?q=the container store&filters={"namespace":"yelp"}

Schema

The schema for Places Crosswalk is here.

Namespaces Supported

Below is a list of the supported namespaces in Places Crosswalk.

Namespace Includes Namespace ID? API Documentation for this service
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
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