add_to_guide
ChatGPTAdd up to 25 places to the end of one of the user's guides (guide_id from list_my_guides or create_guide). Each place is identified like save_place: place_ref, google_maps_url, or name + near. Places without one confident match are returned with candidates and not added. On a published guide the places show up immediately. Places already on the guide are left as they are.
compare_with_friend
ChatGPTCall this when the user asks what they and a specific person have in common, where they should go together, or what that person recommends. Compares the user's places with one friend's, optionally within a destination, and groups them: both_want_to_go (the shortlist for going together), you_want_they_recommend (the friend has been and liked it), they_want_you_recommend, both_recommend, their_recommendations and their_want_to_go (places the user hasn't saved yet), and caution (one of them rated it meh or disliked). friend is a username, a Cerca profile link, or a name matched among people the user follows (call list_friends if unsure).
get_import_status
ChatGPTProgress of a Google Maps list import started with import_google_maps_list (defaults to the most recent).
get_place
ChatGPTDetails for one place: address, category, tags, hours, website, Google rating, the user's own status and note, which friends rated it, and Cerca's own editorial rating (cerca_rating) if any. Takes a place_ref from another Cerca result.
get_taste_profile
ChatGPTThe user's taste as learned from their Cerca ratings and saves: categories and tags they gravitate to or avoid, the cities they know best, how generous their ratings are, and interests they declared. Use it to rank or explain recommendations.
get_travel_context
ChatGPTCall this first whenever the user is planning a trip, visiting, or asking for recommendations in a city, neighborhood, region, or country. Returns, for that destination: places the user loved and liked, their want-to-go list, places they rated meh or disliked (never recommend these), places the people they follow liked or loved, Cerca's own editorial picks (kept separate from friends), and a summary of the user's taste. The user's own places also show which friends saved or rated them too. Pass latitude/longitude of the destination center for best coverage (Google often files places under a ward or suburb rather than the city name).
import_google_maps_list
ChatGPTImport every place in a shared Google Maps list (a maps.app.goo.gl or google.com/maps list link) into the user's want-to-go list. Runs in the background for 30-60 seconds; check progress with get_import_status. Limited to 3 imports per day.
import_places
ChatGPTAdd up to 25 places at once, each as want_to_go or with a rating (loved, liked, meh, disliked). Good for recording a past trip. Each item is identified like save_place: place_ref, a google_maps_url, or name + near. Items without one confident match are returned with candidates and not written; confirm those with the user and resend them with place_ref. Rating notes are public. Existing notes or ratings may be replaced, and rating a place removes it from want-to-go.
list_friends
ChatGPTPeople the user follows on Cerca, with how many places each has rated and saved. Use it to turn a name like "Kyle" into a username for compare_with_friend. The official Cerca account is not a friend and is not listed.
list_my_guides
ChatGPTList the guides the user has made (curated lists of places), drafts included, most recently updated first. Pass guide_id to get one guide with its places and notes. Check here before creating a guide that may already exist.
list_my_places
ChatGPTList the user's own places in Cerca: their want-to-go list and places they rated (loved, liked, meh, disliked). Filter by status, destination (city, neighborhood, region or country), category, or name. For trip planning in one call, prefer get_travel_context.
rate_place
ChatGPTRecord that the user has been to a place and how they felt: loved, liked, meh, or disliked. Creates or updates their rating and removes the place from want-to-go. Identify the place with place_ref (best), a google_maps_url, or name + near. The note is PUBLIC on the user's Cerca profile; ask before writing anything personal. Optional reasons are short chips like great-food or overpriced; unknown reasons are ignored and the allowed list is returned.
remove_place
ChatGPTRemove one of the user's places: takes it off the want-to-go list, or deletes their rating and its note. Confirm with the user first; this can't be undone.
save_place
ChatGPTAdd a place to the user's want-to-go list (places they haven't been to yet). For places the user has already visited, use rate_place instead. Identify the place with place_ref (best), a google_maps_url, or name + near. A name only saves on one confident match; otherwise candidates come back to confirm with the user. The note is private to the user. Supplying a note for an already-saved place replaces its note.
search_places
ChatGPTSearch places already in Cerca by name or category: the user's own places, places the people they follow liked or loved, and other places known to Cerca (cerca_rating marks Cerca's own editorial picks). Does not search the web or Google. Use it to find a place_ref before saving or rating, or to check whether the user already has a place. To add a place that isn't in Cerca, call save_place or rate_place with name + near instead.
update_note
ChatGPTChange the user's note on one of their places. On a want-to-go place the note is private; on a rated place it is the PUBLIC rating note shown on their profile. An empty note clears it.
