Suggest callable places
suggest_placesReturn candidate US businesses to phone for a natural-language request (for example, booking a restaurant or asking a shop a question). Each result carries the venue name, a dialable phone number, why it fits, and a ready-to-send brief. Reads place data only; places no call. An answered request is billed against the same credit balance calls use; a request that returns no candidates or is refused is not. Three fields qualify the answer itself: degraded says it is weaker than a full one and degradation_reason names how, from a set that grows over time — among them a part of the request that cannot be true of any business, dropped before searching, so that the candidates answer what is left of it. short_list_reason answers a different question, why fewer candidates came back than were asked for: thin_pool when too few places qualified, curated when enough did and the ranking step kept only the best matches.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | The most candidates to return, from 1 to 6. Omitted, up to 4 come back, or up to 6 for a niche request. | |
| query | Yes | The request in plain language: what is wanted, where and when, for example a quiet Italian restaurant in Chicago for four on Saturday at 8pm. 1 to 500 characters. | |
| location_hint | No | A neighbourhood, city or ZIP code to search in, up to 200 characters. A place named in the query takes precedence over this hint. A request for somewhere nearby that names no place in either is refused. |