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 and Examples

API access to Places Crosswalk 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 its Yelp page

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

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"}

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 Places Crosswalk 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
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