Truvon

Record your user's answers to a follow-up's questions, by its follow_up id (from report_outcome, or a follow-up due at the top of a search), once the outcome is known. Closed options only, never personal details.

Check up to 10 businesses you found elsewhere (maps, web, a link) before you give your user a phone or send them somewhere: open or closed with dated evidence, the phone its sources agree on, how to act. To look up a business your user names, send its name and town alone; a phone, website or address as well makes the match surer. With the need, you also get two listed businesses that fit it that you did not send. One not found is reported as not in Truvon.

Connect for reporting when your app has not signed in to Truvon itself: a link your user approves with one tap (no account), and a connection code the reporting tools then accept as their connection argument. Searching needs none of this.

Find local businesses that fit a need near a place. Give the service in a few plain words ("furnace repair", "water heater leak"), not the user's sentence; timing goes in open_at. Each result says why it fits, how it meets each requirement you stated (yes, no or needs confirmation, with its source), its hours and whether it is open now, whether it is still in business, the phone, and how to act. 5 results by default; limit asks for more, and max_minutes keeps them close. Truvon has no reviews or ratings, and menus, prices and service details only where a business publishes them.

Get one business's full record by its truvon_id or website domain: each fact with its source and date, every source's value where they disagree, prices, offers, hours and every way to act. Open it for a finalist, and whenever a phone or address matters. A business Truvon does not list has no record.

Get every value one fact of a business (phone, hours, address, name) has held, with which source said it and when: how settled a value is.

Get the status of a job you arranged and the business's updates, by the job id report_outcome returned, when your user asks about it.

Get the next page of a search by the next_cursor it returned (kept 24 hours). Narrowing the need usually beats paging.

Note the person's tap on a result's button in Truvon's results view, which calls it; agents never need to.

Record what a business told you that its record lacks ("yes, certified kosher"): the question and its answer in its words, with the business's truvon_id.

Report a business Truvon does not list (check_places_results says so) that fits your user's need and that you found elsewhere (the web, a map): send its name, its own website, phone, address and the town, with the need and the search_id. Its own website is queued to be read so it can be listed for every agent.

Record what happened when you acted for your user (booked, ordered, called, got a quote), with the search_id and the business's truvon_id. When something was arranged it returns a follow-up, questions for your user once the outcome is known, and for a job a job id.

Show your user a search's results in one view with what you found on the web for each (a rating and where it comes from, the review count, a link, a one-line note). Optional, after find_local_businesses. Your additions are labeled as yours, never as Truvon's, and never change rank.