search_places_by_description
Places that match a plain-words description, with address, rating, opening hours and how busy each is hour by hour. ₹0.79 per call; a result that finds nothing is ₹0.
What it does
Places (cafés, restaurants, shops, gyms, venues, offices) that match a description in plain words ("quiet cafés in Indiranagar good for working on a laptop"), up to ten per call. Each of data.results[] has the place's title and text: a short Markdown record with the address, area, map coordinates, whether it is open, its categories, rating and number of reviews, price level where known, opening hours by day, and its popular times (how busy it usually is, hour by hour, and the usual wait).
Use it when the place is easier to describe than to name, or to pick a time or a spot by how busy it is; search_maps lists places for a keyword with phone numbers and websites, search_local returns Google's local pack, get_place reads one known place, and get_maps_reviews its reviews. Flat price per call for up to ten places; an empty result is free.
India: name the area and city in the description; there is no country setting.
Inputs
Generated from the contract captured from staging on 2026-11-20.
| Field | Type | Required | Description |
|---|---|---|---|
query | string | yes | The place in plain words, with the area and city ("vegan restaurants in Bandra, Mumbai, open late"). |
numResults | integer | no | How many places, 1 to 10. Default 10.; min 1, max 10 |
What drives the cost
Flat price per call for up to ten places (numResults 1 to 10, default 10); an empty result is free. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹0.79 per call (cost_paise: 79) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.19 (hold_paise: 119); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_places_by_description" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_places_by_description" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"search_places_by_description","input":{"query":"vegan restaurants in Bandra, Mumbai, open late","numResults":10}}'
What comes back
data, as the live check of 2026-11-20 recorded it, trimmed:
{
"results": [
{
"title": "Firdos Restaurant",
"text": "# Firdos Restaurant\n\nFirdos Restaurant is a restaurant in D Block BKC, Naupada, Bandra East, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** Gound floor Building no.2, Anant Kanekar Marg, near Bandra court, opp. Amber restaurant,…"
},
{
"title": "The Village Shop",
"text": "# The Village Shop\n\nThe Village Shop is a restaurant in Bandra West, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** 5AA, Mac Ronells Bungalow, Saint Andrews Ext, next to Learner’s Academy, Bandra West, 400050, India\n- **Area:** B…"
},
{
"title": "Pause - Your Everyday Cafe",
"text": "# Pause - Your Everyday Cafe\n\nPause - Your Everyday Cafe is a café in Bandra West, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** Shop No. 27, Vora House, A/B, Pali Mala Rd, Bandra West, 400050, India\n- **Area:** Bandra, State of…"
}
]
}
Notes
- Each record is Markdown text, cut at a fixed length: location, details and opening hours come first, then popular times.
- Flat price per call for up to ten places (numResults 1 to 10, default 10); an empty result is free.
- Describe the place and name the area and city; it does not take a map position or a radius.
Siblings
This page as Markdown: /docs/tools/search_places_by_description.md. Something wrong or missing: hello@parel.si.