/
September POI Updates
Search
Try Notion
September POI Updates
Roadmap
New Guides:
https://meetkai.notion.site/Mk-POI-Guide-603022f61df6470e8c5c278085bf3d37
Search updates
More ways to search by location:
There are now three geolocation search modes supported. Point, Bounding Circle, and Bounding box. For getting batch amounts of data for a region it is suggested to use either the circle of box for a region. These are hard filters, please refer to the userCircularMapView and userMapView query parameters for example on usage: https://meetkai.cloud/docs#/poi/local_search_api_poi_alpha_LocalSearch_get
Ways to search by categroy:
We provide search by metadata using the filter_string query parameter. A subset of the lucene query string grammar is supported.
Examples:
curl "https://staging-asia.meetkai.cloud/api/poi/alpha/LocalSearch?userLocation=19.4326,-99.1332,5000&filter_string=(type:restaurant)" -H X-API-KEY:cd45d4a9b044be77391b37b3d0f8cdd6
Bash
curl "https://staging-asia.meetkai.cloud/api/poi/a99.1332,5000&filter_string=(type:'restaurant' or type:'hotel')" -H X-API-KEY:cd45d4a9b044be77391b37b3d0f8cdd6
Bash
Pagination
We support pagination now through offset based skips. You can use the offset parameter and maxResults to determine if more pages of results are available.
Click Through links
If you are indexing/caching data rather than querying at request time, you are required to use our templated clickthrough for the more details link in an APP. This link will have a format that looks like:
https://meetkai.cloud/g/{slug}?q={query}&uid_hash={uid_hash}
JavaScript
slug will be the item_id
query is the string that was used as part of the search
uid_hash is a hash of the APP's unique identifier for a user or a device ID. This should not be PII.
Searching by Country Code
We also support country_code that allows filtering on country codes based on ISO 3166-1 two letter codes. I.e FR for France. In order to search for country code use the country_code:FR within the filter_string query parameter.
Request
curl "https://staging-asia.meetkai.cloud/api/poi/alpha/LocalSearch?userLocation=48.868489,2.447596,1000&filter_string=country_code:FR" -H X-API-KEY:cd45d4a9b044be77391b37b3d0f8cdd6
Bash
Response
{ "uid": "g187103::d13431201", "name": "Loco Loca", "data_sources": [ { "name": "Tripadvisor", "source_id": "tripadvisor", "source_type": "link", "url": "https://www.tripadvisor.com/Restaurant_Review-g187103-d13431201-Reviews-Loco_Loca-Rennes_Ille_et_Vilaine_Brittany.html", "icon": "https://public.meetkai.com/images/data_sources/tripadvisor.webp" }, { "name": "Yelp", "source_id": "yelp", "source_type": "link", "url": "https://www.yelp.com/biz/loco-loca-rennes", "icon": "https://public.meetkai.com/images/data_sources/yelp.webp" } ], "kai_score": 0.6963636363636364, "alternative_names": [], "description": "", "features": [ "Seating", "Wheelchair Accessible", "Free Wifi", "Table Service", "Vegetarian Friendly", "happy hour specials", "tv", "Reservations", "Serves Alcohol", "Full Bar", "offers takeout", "bike parking", "free wi-fi", "Dogs Allowed", "Outdoor Seating", "takes reservations", "Vegan Options", "Accepts Credit Cards", "Street Parking", "waiter service" ], "formatted_address": "rue Comte de Lanjuinais", "address": { "address_country": "France", "address_locality": "", "address_region": "Brittany", "postal_code": "35000", "street_address": "rue Comte de Lanjuinais" }, "geo_point": { "name": "", "lat": 48.10806, "lon": -1.681849 }, "guides": [], "hours": [ { "day": "Sun", "gte": "11:00", "lte": "15:00" }, { "day": "Mon", "gte": "08:00", "lte": "00:00" }, { "day": "Tue", "gte": "08:00", "lte": "00:00" }, { "day": "Wed", "gte": "08:00", "lte": "00:00" }, { "day": "Thu", "gte": "08:00", "lte": "00:00" }, { "day": "Fri", "gte": "08:00", "lte": "00:00" }, { "day": "Sat", "gte": "10:00", "lte": "00:00" } ], "imgs": [ "https://media-cdn.tripadvisor.com/media/photo-s/11/ed/0e/ad/burgers.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/1a/87/25/1c/la-pause-s-impose-sur.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/78/f1/pinchos-ceviche-tiradito.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/78/b9/c-est-aussi-une-offre.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ed/0e/bd/churrascos.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/79/19/tapas-a-partagerou-pas.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/79/0b/selection-de-cocktails.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/79/03/un-cadre-vraiment-sympa.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/78/fc/grill-interieur.jpg", "https://media-cdn.tripadvisor.com/media/photo-s/11/ec/78/a3/bienvenido-locoloca.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/5QlyTJY6A8rPZqMLkv5Ghg/o.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/If5sLURwEJ83z0HgA2CL0Q/o.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/0dvCtnrKlxmg4X6RqmuO5Q/o.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/18XMn6XMOVQH9Jg034-S0Q/o.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/TLeDFcZRwwHQnOX4TSJXug/o.jpg", "https://s3-media0.fl.yelpcdn.com/bphoto/VIX4K1XWze_ZqNM8nN4hRA/o.jpg" ], "is_chain": false, "is_verified": false, "labels": [ "European", "Spanish", "South American", "Central American", "tapas bars", "Latin", "Portuguese", "Mexican", "brasseries" ], "meals": [ "Late Night", "Lunch", "Dinner", "Brunch", "Drinks" ], "menu": [ { "category": "", "description": "", "detailed_price": { "currency": "USD", "formatted": "€7.00", "value": 7.0 }, "image": "", "name": "Tacos de fruits", "price": 7.0, "url": "" }, { "category": "", "description": "", "detailed_price": { "currency": "USD", "formatted": "€17.00", "value": 17.0 }, "image": "", "name": "COEUR de rumsteak", "price": 17.0, "url": "" }, { "category": "", "description": "", "detailed_price": { "currency": "", "formatted": "", "value": 0.0 }, "image": "", "name": "Brocheta de légumes grillés", "price": 0.0, "url": "" }, { "category": "", "description": "", "detailed_price": { "currency": "USD", "formatted": "€7.00", "value": 7.0 }, "image": "", "name": "Rabadanas", "price": 7.0, "url": "" } ... ], "price": "$$ - $$$", "reviews": [], "scores": [ { "provider": "tripadvisor", "provider_name": "Tripadvisor", "ratings": 474.0, "score": 4.0 }, { "provider": "yelp", "provider_name": "Yelp", "ratings": 4.0, "score": 3.0 } ], "telephone": "+33 2 99 92 25 21", "timezone": "Europe/Paris", "type": [ "restaurant" ], "website": "http://www.locoloca.com", "country_code": "FR", "language_code": "en", "gcid": [ "restaurant" ], "pcid_1": [ "eating and drinking" ], "pcid_2": [ "restaurant" ], "pcid_3": [ "latin", "portuguese", "mexican", "restaurant", "european", "spanish", "south american", "central american" ], "localized_replies": { "en": [ "How about this unique place that serves amazing Central American cuisine.", "How about this great restaurant that serves Portuguese cuisine.", "This is a great restaurant that serves Latin cuisine.", "Here is a restaurant for European cuisine. ", "This restaurant is known for it's delicious South American cuisine." ] }
JSON
💡
Notice the "country_code": "FR" field in the response. This will be the country you filtered for.
Updates to Empty Descriptions
For items where the description is empty, we have synthesized descriptions according to the attributes of the given item. Those descriptions can be accessed via localized_replies . There will be a list of options to use as the description I.e This is a great restaurant that serves Latin cuisine.
"localized_replies": { "en": [ "This is a great restaurant that serves Latin cuisine.", "Here is a restaurant for European cuisine. ", "This restaurant is known for it's delicious South American cuisine." ] }
JSON