{"id":13936548,"url":"https://github.com/octohedron/TouristFriend","last_synced_at":"2025-07-19T22:30:47.621Z","repository":{"id":144247171,"uuid":"91181142","full_name":"octohedron/TouristFriend","owner":"octohedron","description":"🌆 TouristFriend API lets you query Google Places, Yelp and Foursquare at the same time, with Bayesian rankings!","archived":false,"fork":false,"pushed_at":"2019-01-28T10:09:37.000Z","size":30,"stargazers_count":30,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-08T23:23:57.386Z","etag":null,"topics":["flask","google-places","python","yelp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/octohedron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-13T14:48:39.000Z","updated_at":"2024-01-18T15:05:11.000Z","dependencies_parsed_at":"2023-05-29T05:45:28.804Z","dependency_job_id":null,"html_url":"https://github.com/octohedron/TouristFriend","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octohedron%2FTouristFriend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octohedron%2FTouristFriend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octohedron%2FTouristFriend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octohedron%2FTouristFriend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/octohedron","download_url":"https://codeload.github.com/octohedron/TouristFriend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226686729,"owners_count":17666928,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","google-places","python","yelp"],"created_at":"2024-08-07T23:02:46.461Z","updated_at":"2024-11-27T04:31:11.172Z","avatar_url":"https://github.com/octohedron.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# TouristFriend\n\n\nTouristFriend is an API for searching and combining results from Google Places and Yelp.\n\nFor the foursquare implementation check out the branch `foursquare`\n\nReturns a combined list of places ranked by their ratings as a Bayesian estimate\n\n### Try it out\n```Bash\n$ curl http://touristfriend.club/api/40000/29.743883,-95.361621/restaurants\n```\n\n## Sample output\n\n```JavaScript\n[\n  {\n    \"Rating\": \"9.49\",\n    \"Sources\": 1,\n    \"Number_of_Ratings\": 868,\n    \"Location\": \"37.761594,-122.42427\",\n    \"Name\": \"Pizzeria Delfina\"\n  },\n  {\n    \"Rating\": \"9.39\",\n    \"Sources\": 1,\n    \"Number_of_Ratings\": 404,\n    \"Location\": \"37.7682006597,-122.421604657\",\n    \"Name\": \"Shizen\"\n  },\n  {\n    \"Rating\": \"9.32\",\n    \"Sources\": 1,\n    \"Number_of_Ratings\": 45,\n    \"Location\": \"37.763093,-122.424281\",\n    \"Name\": \"Turner's Kitchen\"\n  },\n  // Up to 15 results...\n]\n```\n\nURI Breakdown: `http://touristfriend.club/api/{meters}/{latitude},{longitude}/{query}`\n\n## Setup\nYou'll need to acquire API keys for each of the individual services and add them to api_keys.py.\n\n+ [Google Places](https://developers.google.com/places/web-service/get-api-key)\n+ [Yelp](https://www.yelp.com/developers/v3/manage_app)\n\n### Set environment variables\n\n```Bash\n# Google Places\n$ export G_API=YOUR_GOOGLE_API_KEY\n\n# Yelp\n$ export YELP_API_KEY=YOUR_YELP_API_KEY\n\n# Flask app, standing on the root of the cloned repo\n$ export FLASK_APP=$(pwd)/touristfriend/__init__.py\n```\n### Install dependencies\n\n```Bash\npip install -U Flask flask-cors\n```\n\n### Run it\n\n```Bash\n# For localhost\n$ flask run # 127.0.0.1\n# For external server\n$ flask run --host \"0.0.0.0\" \u0026\n```\n\n### Try it\n\n```Bash\n$ curl http://localhost:5000/api/40000/48.888001,2.337442/restaurants\n```\n\n### With Docker example\n\n```Bash\n$ docker build -t tfriend --build-arg GMAPS_KEY=YOUR_GOOGLE_MAPS_KEY \\\n  --build-arg G_API=YOUR_GOOGLE_API_KEY \\\n  --build-arg YELP_API_KEY=YOUR_YELP_API_KEY . \u0026\u0026 \\\n  docker run -p 5000:5000 tfriend\n```\n\nFeel free to use the `touristfriend.club` API for testing or demoing, if you plan on using it on production, consider deploying it yourself.\n\nLICENSE: MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctohedron%2FTouristFriend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foctohedron%2FTouristFriend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctohedron%2FTouristFriend/lists"}